---
title: "Number Field"
description: "A numeric field with increment, decrement, constraints and locale formatting."
---

Interactive preview: https://ui.coderocket.app/docs/components/number-field

## Usage

Get this component from a [saved library export](/docs/export) or the [connected CLI](/docs/agents). The imports below refer to local files installed in your app.

Import `styles/components.css`, then `styles/theme.css` once. Wrap your app in `ThemeScope` from `components/ui/utils` so typography, focus and overlays share the theme. The [installation guide](/docs/export) covers runtime dependencies and React/Next.js setup.

```tsx
import { NumberField } from './components/ui/number-field';

<NumberField label="Team size" defaultValue={5} min={1} max={100}/>
```

## Design system

This component consumes your semantic colors, spacing, typography and shape tokens. Import the compiled styles and your theme once as described in [Export](/docs/export).

## Behavior and accessibility

- Provide meaningful labels for interactive controls.
- Connect action callbacks to your application logic.
- Verify keyboard navigation and contrast in your application.

Status: **experimental** during early access. Sample previews do not send emails, process payments or upload files to a service.

## Source and props

This is the exported source, using the same implementation as the editor.

```tsx
"use client";
import { useId, type ComponentProps } from "react";
import { NumberField as Base } from "@base-ui/react/number-field";
import { cx } from "./utils";
export type NumberFieldProps = Omit<
  ComponentProps<typeof Base.Root>,
  "className" | "children"
> & {
  label: string;
  className?: string;
};
export function NumberField({
  label,
  id,
  className,
  step = 1,
  defaultValue = 0,
  locale = "en-US",
  ...props
}: NumberFieldProps) {
  const generatedId = useId();
  const inputId = id ?? generatedId;
  return (
    <Base.Root
      {...props}
      id={inputId}
      step={step}
      defaultValue={defaultValue}
      locale={locale}
      className={cx("cr-number-field", className)}
    >
      <Base.ScrubArea>
        <label htmlFor={inputId} className="cr-label">
          {label}
        </label>
        <Base.ScrubAreaCursor>
          <svg
            width="16"
            height="16"
            viewBox="0 0 24 24"
            fill="none"
            stroke="currentColor"
            strokeWidth="2"
            strokeLinecap="round"
            strokeLinejoin="round"
            aria-hidden="true"
          >
            <path d="m5 8-4 4 4 4M1 12h22m-4-4 4 4-4 4" />
          </svg>
        </Base.ScrubAreaCursor>
      </Base.ScrubArea>
      <Base.Group className="cr-number-group">
        <Base.Decrement aria-label={"Decrease " + label}>
          <svg
            width="16"
            height="16"
            viewBox="0 0 24 24"
            fill="none"
            stroke="currentColor"
            strokeWidth="2"
            strokeLinecap="round"
            aria-hidden="true"
          >
            <path d="M5 12h14" />
          </svg>
        </Base.Decrement>
        <Base.Input />
        <Base.Increment aria-label={"Increase " + label}>
          <svg
            width="16"
            height="16"
            viewBox="0 0 24 24"
            fill="none"
            stroke="currentColor"
            strokeWidth="2"
            strokeLinecap="round"
            aria-hidden="true"
          >
            <path d="M5 12h14M12 5v14" />
          </svg>
        </Base.Increment>
      </Base.Group>
    </Base.Root>
  );
}
```