104Get started
HextaUI

Progress: Long labels

Long names wrap onto their own lines and the value stays on the end. Rings work as compact status beside each row.

  • x
    quarterly-report-final-v3-approved-by-legal-and-finance.pdf
    x
  • x
    IMG_20260914_183022_HDR_edited_export.jpg
    x
  • x
    brand-assets.zip
    x
import {
  Progress,
  ProgressCircle,
  ProgressLabel,
  ProgressValue,
} from "@/components/ui/progress"

const files = [
  {
    name: "quarterly-report-final-v3-approved-by-legal-and-finance.pdf",
    value: 64,
  },
  { name: "IMG_20260914_183022_HDR_edited_export.jpg", value: 100 },
  { name: "brand-assets.zip", value: 12 },
]

export function ProgressFiles() {
  return (
    <ul className="flex w-full max-w-sm flex-col gap-5">
      {files.map((file) => (
        <li key={file.name} className="flex items-start gap-3">
          <ProgressCircle value={file.value} aria-label={file.name} />
          <div className="min-w-0 flex-1">
            <Progress value={file.value} size="sm">
              <ProgressLabel>{file.name}</ProgressLabel>
              <ProgressValue />
            </Progress>
          </div>
        </li>
      ))}
    </ul>
  )
}

Add this example

This adds the example as components/examples/progress/files.tsx, together with the Progress component and the HextaUI theme tokens it needs.

pnpm dlx shadcn@latest add https://hextaui.com/r/progress-files.json

To add only the component, follow the Progress installation.

Props in this example

The Progress props this example sets, from the API reference.

Progress

PropTypeDefault
valuenull makes the bar indeterminate.
number | null–
size
"xs" | "sm" | "default" | "lg""default"

ProgressCircle

PropTypeDefault
valuenull spins an arc.
number | null–

Every prop is in the Progress API reference.

More Progress examples

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

Related components