Skip to contentKino
Skip to Content

Description list

Pairs of a label and its value, lined up as a table lines up its columns. Details start after their labels, amounts line up on the end edge over a total, and in a narrow column each value goes under its label.

npx shadcn add https://kinoui.com/r/description-list.json
Share on

Examples

Status
Paid
Billing email
accounts@kinoui.com
Payment method
Visa ending 4242, charged Nov 15
Payment ID
pi_3QkX9v2eZvKYlo2C1nJ8Hq7T

Actions

Values start on one line after the labels. DescriptionListAction holds buttons at the row’s end, such as Copy or Edit, and DescriptionListValue keeps the value’s text together beside them. An xs button never makes its row taller.

Size
18.4 MB
Type
Figma file
Uploaded by
MCMaya Chen
Last opened
Never
Folder
Kino / Design / Checkout / 2026 / Q4 / Final handoff / Approved
SHA-256
9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08

Long values

A long ID breaks onto the next line. truncate on the value cuts it to one line instead, with Copy for the whole.

Kino Team, 7 seats, billed monthly from Nov 15
$84.00
Unused time on Kino Starter, Nov 15 to Nov 21
−$9.50
VAT (20%)
$14.90
Total
$89.40

Total

align="end" lines amounts up on the end edge, as a receipt does, and variant="total" puts the sum under a line. A long label wraps beside its amount.

Plan
Kino Team
Seats
7 of 10
Seats × $12
$84.00
VAT (20%)
$16.80
Due on Dec 15
$100.80

Values that change

Numbers line up as they change, and an Animated number rolls each one to its new value.

Installation

npx shadcn@latest add https://kinoui.com/r/description-list.json
Files
lib/reduce-motion.tscomponents/kino/description-list.tsx
Packages
class-variance-authority

New to Kino? Installation covers what your project needs first and the @kino namespace.

API reference

DescriptionList

PropTypeDefaultDescription
align"start""end""start"Where the values sit. Start sets the labels in one column, as wide as the widest label up to half the list, and starts every value after it: for details. End puts them on the end edge: for amounts and counts. Each list sizes its own labels’ column.

DescriptionListItem

PropTypeDefaultDescription
variant"default""total""default"Total puts the row under a line, with its label in the foreground.

Data attributes

AttributeOnDescription
data-alignDescriptionListIts alignment.
data-variantDescriptionListItemIts variant.

Accessibility

  • It’s a <dl>, each pair a <dt> and a <dd> in a <div>, which screen readers read as a term and its description.
  • Name an action by what it acts on, such as “Copy payment ID”, since the buttons in a list sit beside many values.
  • A value cut to one line is still read whole by a screen reader. Give sighted users a way to the whole value too, such as Copy or a title.
  • A button that turns disabled under the keyboard’s focus, such as a stepper at its limit, takes focusableWhenDisabled, so focus stays on it.
  • When values change because of an action on the page, say what changed in a status region, as the seats example does.