Skip to Content

HowItWorksSection

Explain a product or process with semantic ordered steps, media, actions, and optional carousel navigation.

HowItWorksSection describes a process with consumer-provided ordered steps. Each item needs a stable ID and title; descriptions, icons, media, custom content, and actions are optional.

Beta API maturity: Beta.

Installation

import { HowItWorksSection, type HowItWorksItem } from "@puzzle-ui/pieces";

Variant previews

List-based variants use an ordered list. Visible number markers are reserved for numbered, timeline, connected, and process; other variants lead with their supplied icons or media. The carousel variant includes named controls and left/right arrow-key navigation.

steps - A direct sequence of instructions or milestones.

390 × 844

numbered - Steps whose order is central to the process.

390 × 844

timeline - A process described along a chronological line.

390 × 844

cards - Each step explained in its own card.

390 × 844

alternating - A staggered sequence for a short process story.

390 × 844

horizontal - A concise row of steps on wide screens.

390 × 844

vertical - A stacked process suitable for narrow pages.

390 × 844

connected - A sequence where visual connectors clarify order.

390 × 844

image-steps - Steps that rely on consumer-supplied images.

390 × 844

video-steps - Steps that include consumer-supplied video.

390 × 844

process - A compact overview of a business process.

390 × 844

split - A process paired with explanatory content or media.

390 × 844

carousel - A keyboard-navigable step presented one at a time.

390 × 844

editorial - A detailed, text-led process explanation.

390 × 844

API

PropTypeDescription
variantHowItWorksVariantSelects one of fourteen process layouts; defaults to steps.
stepsreadonly HowItWorksItem[]Ordered content with stable id and required title.
HowItWorksItem.mediaReactNodeOptional image, video, or other media.
HowItWorksItem.iconReactNodeOptional consumer-provided icon.
HowItWorksItem.content / actionReactNodeOptional additional content and action.
carouselLabelstringAccessible carousel name; defaults to Process steps.
Shared section propsSectionRootProps and heading propsSemantic root, theme, native attributes, heading, actions, and children.

Usage

<HowItWorksSection
  variant="numbered"
  title="How it works"
  steps={[
    { id: "connect", title: "Connect your tools", description: "Choose your services." },
    { id: "organize", title: "Organize the workflow" },
  ]}
/>

Empty steps omit the ordered list. The component does not infer a process or perform step navigation outside the carousel presentation.

Accessibility

The default composition uses ordered-list semantics. The carousel provides labeled controls and arrow-key support; provide concise labels and useful alternatives for informative media.