Skip to Content

CTASection

Invite visitors to a consumer-defined next step with responsive call-to-action layouts and optional media.

CTASection composes a message, optional media, actions, and custom children. It does not implement a newsletter form, download, trial, contact flow, or application behavior; consumers provide those elements.

Beta API maturity: Beta.

Installation

import { CTASection } from "@puzzle-ui/pieces";

Variant previews

Each preview shares the same typed content slots while applying its named composition. Theme and background behavior inherit from the shared UI section props.

centered - A focused message with centered actions.

390 × 844

split - A call to action beside consumer-provided media.

390 × 844

banner - A compact banner near the end of a page.

390 × 844

card - A contained action within a card-like surface.

390 × 844

full-width - A broad call to action spanning the section.

390 × 844

image - A message paired with an image or illustration.

390 × 844

background - A call to action with consumer-styled background media.

390 × 844

gradient - A themed gradient treatment using design tokens.

390 × 844

newsletter - A prompt whose form is supplied by the consumer.

390 × 844

trial - A product trial invitation with a clear next step.

390 × 844

download - A download prompt with consumer-provided actions.

390 × 844

contact - A direct invitation to contact the organization.

390 × 844

app - A promotion for a mobile or desktop application.

390 × 844

minimal - A restrained final prompt with little decoration.

390 × 844

editorial - A text-led call to action in an article layout.

390 × 844

floating - A compact, contained prompt separated from page content.

390 × 844

API

PropTypeDescription
variantCTAVariantSelects one of sixteen call-to-action presentations; defaults to centered.
title / description / eyebrowReactNodeShared section heading content.
primaryAction / secondaryActionReactNodeConsumer-provided next steps.
mediaReactNodeOptional consumer-provided media.
childrenReactNodeAdditional composable content such as a form.
Shared section propsSectionRootPropsSemantic root, theme, native attributes, width, and spacing.

Usage

<CTASection
  variant="trial"
  title="Ready to get started?"
  description="Try the workflow with your team."
  primaryAction={<a href="/signup">Start a trial</a>}
  secondaryAction={<a href="/docs">Read the guide</a>}
/>

The action slots are omitted when not supplied. Provide links, buttons, forms, and their loading/error behavior from the consuming application.

Accessibility

Use descriptive action names and maintain a logical heading level. If a form is passed through children, provide its own labels, validation messages, and submission feedback.