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>
);