104Get started
HextaUI

Input OTP: Controlled

Pass value and onValueChange. The value is always the filtered code, never longer than length.

Enter your code.

"use client"

import * as React from "react"

import {
  InputOTP,
  InputOTPGroup,
  InputOTPSlot,
} from "@/components/ui/input-otp"

export function InputOTPControlled() {
  const [value, setValue] = React.useState("")

  return (
    <div className="flex max-w-full min-w-0 flex-col items-center gap-3">
      <InputOTP
        length={6}
        value={value}
        onValueChange={setValue}
        aria-label="Verification code"
      >
        <InputOTPGroup>
          <InputOTPSlot />
          <InputOTPSlot />
          <InputOTPSlot />
          <InputOTPSlot />
          <InputOTPSlot />
          <InputOTPSlot />
        </InputOTPGroup>
      </InputOTP>
      <p className="text-sm text-muted-foreground tabular-nums">
        {value === "" ? "Enter your code." : `You entered: ${value}`}
      </p>
    </div>
  )
}

Add this example

This adds the example as components/examples/input-otp/controlled.tsx, together with the Input OTP component and the HextaUI theme tokens it needs.

pnpm dlx shadcn@latest add https://hextaui.com/r/input-otp-controlled.json

To add only the component, follow the Input OTP installation.

Props in this example

The Input OTP props this example sets, from the API reference.

InputOTP

PropTypeDefault
lengthRequired. The number of slots; render the same number of InputOTPSlot parts.
number–
value
string–
onValueChange
(value: string, details) => void–

Every prop is in the Input OTP API reference.

More Input OTP examples

See them all, with keyboard support and accessibility notes, on the Input OTP page.

Related components