Installation

npx payload-components add call-to-action-signup

What it installs

Copies 4 source files into your project:

src/blocks/shared/callToActionFields.tsshared
src/blocks/shared/safeUrls.ts
src/blocks/CallToActionSignup/config.ts
src/blocks/CallToActionSignup/Component.tsx

…and makes 4 edits to wire the block into your project:

Registers the block	`src/collections/Pages/index.ts`
Maps the renderer	`src/blocks/RenderBlocks.tsx`
Regenerates types	`src/payload-types.ts`
Regenerates the admin import map	`src/app/(payload)/admin/importMap.js`

Registers the blocksrc/collections/Pages/index.ts

Maps the renderersrc/blocks/RenderBlocks.tsx

Regenerates typessrc/payload-types.ts

Regenerates the admin import mapsrc/app/(payload)/admin/importMap.js

callToActionFields.ts is shared source for this component family. Components that install the same path reuse that local copy, and re-running an install never overwrites a copy you have changed.

Re-running the CLI install detects existing source and wiring, then records install state in .payload-components/state.json.

This variant also installs the shadcn button component and adds lucide-react for the form's mail and send icons. The form is server-rendered — set action to a same-origin handler such as /api/newsletter.

Content model

title and description come from the shared callToActionFields base; the form fields are specific to this variant.

Prop

Type

Usage

Add the block to a page. In the Payload admin, open (or create) a Page and add the CallToActionSignup block to its layout.

Fill the content. Complete the fields from the content model above — the component ships sample content you can start from.

Publish. Save and publish the page; the block renders through RenderBlocks on the frontend, fully typed — no extra wiring.

Requirements

Target: payload-website-starter, payload-blocks-app
Payload: v3 (3.25 or newer) / v4 (experimental)
Next.js: 15 / 16 with v316 (16.4 or newer) with v4
shadcn UI: button

Payload v4 support is experimental: it needs Next.js 16 (16.4 or newer) and Node.js 24.22.1 or newer. Payload v3 (3.25 or newer) stays fully supported.

Your project must already expose components.json, src/payload.config.ts — the surfaces patched by payload-components add. The CLI verifies this against the support matrix before touching anything.