Skip to Content

BenefitsSection

Communicate customer outcomes with responsive benefit lists, cards, icons, media, and featured content.

BenefitsSection focuses on outcomes rather than feature details. Each item has a stable ID and title, with optional description, icon, media, action, or featured emphasis.

Beta API maturity: Beta.

Installation

import { BenefitsSection, type BenefitItem } from "@puzzle-ui/pieces";

Variant previews

The collection adapts from a single column on narrow screens to wider grid layouts when there is room.

grid - A balanced collection of customer benefits.

390 × 844

split - Benefits beside a consumer-provided image or media.

390 × 844

list - A straightforward vertical list of outcomes.

390 × 844

cards - Benefits presented as distinct visual cards.

390 × 844

icons - Short benefits supported by icons.

390 × 844

numbered - A sequenced set of benefits or outcomes.

390 × 844

alternating - A staggered layout for a short feature story.

390 × 844

checklist - A scannable list of included outcomes.

390 × 844

editorial - More detailed benefit descriptions.

390 × 844

featured - A set with one priority benefit.

390 × 844

compact - A dense layout with less card spacing.

390 × 844

comparison - Benefits that support comparing product outcomes.

390 × 844

API

PropTypeDescription
variantBenefitsVariantSelects one of twelve benefit compositions; defaults to grid.
itemsreadonly BenefitItem[]Benefit content with stable id, required title, and optional slots.
BenefitItem.iconReactNodeOptional consumer-provided icon.
BenefitItem.mediaReactNodeOptional media node.
BenefitItem.actionReactNodeConsumer-provided action.
BenefitItem.featuredbooleanEmphasizes the item in supported variants.
Shared section propsSectionRootProps and heading propsSemantic root, theme, native attributes, heading, actions, and children.

Usage

<BenefitsSection
  variant="checklist"
  title="Benefits for your team"
  items={[
    { id: "time", title: "Save time", description: "Reduce repetitive tasks." },
    { id: "clarity", title: "Gain clarity" },
  ]}
/>

The section does not imply product-specific claims or generate content. Empty collections omit the list while preserving optional heading content.

Accessibility

Use descriptive titles and provide text alternatives through the consumer-provided media. Keep icon-only meaning in the item's text as well.