PPolaris ComponentsConnect an agent

DescriptionList

Pairs a set of terms with their descriptions, such as an order summary or a plan's details, so related facts read as one block.

Preview

Code

Example.jsx
import { Card, BlockStack, InlineStack, Text, Badge, DescriptionList, Divider } from '@shopify/polaris';

const ORDER_SUMMARY = [
  { term: 'Order number', description: '#1024' },
  { term: 'Placed on', description: 'July 12, 2025 at 4:34 pm' },
  {
    term: 'Payment',
    description: (
      <InlineStack gap="200" blockAlign="center">
        <Text as="span">Visa ending in 4242</Text>
        <Badge tone="success" progress="complete">
          Paid
        </Badge>
      </InlineStack>
    ),
  },
  {
    term: 'Shipping address',
    description: 'Jaydon Stanton, 150 Elgin St, Ottawa ON K2P 1L4, Canada',
  },
  { term: 'Delivery method', description: 'Standard shipping (5 to 7 business days)' },
  { term: 'Items', description: '3 items — kettle, carafe, sampler' },
  {
    term: 'Total',
    description: (
      <Text as="span" fontWeight="semibold" numeric>
        $969.44
      </Text>
    ),
  },
];

export const Example = () => (
  <Card>
    <BlockStack gap="100">
      <Text as="h2" variant="headingMd">
        Order summary
      </Text>
      <Divider />
      <DescriptionList items={ORDER_SUMMARY} />
    </BlockStack>
  </Card>
);