Page blocksFooter

Footer Columns

A brand block beside labelled columns of navigation links, closed by a copyright rule.

v0.2.0Page blockpayload-website-starter

import type { Block } from 'payload'

import { footerFields, footerLinkFields } from '@/blocks/shared/footerFields'

export const FooterColumns: Block = {
  slug: 'footerColumns',
  // Existing apps must migrate stored data before adopting this identifier:
  // https://www.payload-components.xyz/docs/registry#installed-source-and-migrations

Installation

npx payload-components add footer-columns
Manualnpx shadcn@latest add https://www.payload-components.xyz/r/footer-columns.json

The registry copy brings the source files only; register the block and map its renderer yourself, or let the CLI command above do both.

Usage

Editors add Footer Columns from a Page layout's block picker. This is the form they fill.

Footer Columns

Block
Brand Label
Acme
Tagline
The analytics workspace product teams open every day.
Copyright
© Acme 2026 — Present
Groups
  1. 01
    Product4 links
  2. 02
    Company4 links
  3. 03
    Legal4 links
  1. 1Add the block to a Page from the layout block picker.
  2. 2Fill the fields as above.
  3. 3Publish. RenderBlocks renders the block, fully typed.

Footer blocks render inside the Pages layout like every other block. To use one as site-wide chrome instead, render the component directly in your root layout and pass it content from a global.

Content model

logo, brandLabel, and copyright come from the shared footerFields base that every Footer variant spreads; tagline and groups are specific to this variant. Each group renders as its own labelled navigation region, so the group name is both the visible column heading and the accessible name for that set of links.

Prop

Type

Each item in groups carries:

Prop

Type

Each item in links carries:

Prop

Type

What it installs

Composition

How the block hangs together in Payload

Pageslayout[]FooterColumnsbrandLabeltaglinecopyrightgroups[]namelinks[]  link
Fields
src/blocks/FooterColumns/config.ts
Render
src/blocks/FooterColumns/Component.tsx

Files

Copies 5 files into your project. Files tagged shared are reused across the family.

safeUrls.tsshared
footerUrls.tsshared
footerFields.tsshared
config.ts
Component.tsx

Edits

Wires FooterColumns into the project in 4 places.

  • 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
safeUrls.ts and footerUrls.ts and footerFields.ts are shared source for this component family. Components that install the same path reuse your local copy, and re-running an install never overwrites a copy you have changed.

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

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
None

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.


Layout adapted from tailark/blocks (MIT), retokenized onto the Payload Components design system.

In this family

Footer ColumnsCurrent
A brand block beside labelled columns of navigation links, closed by a copyright rule.
Footer Simple
A compact footer keeping the brand and one wrapped row of links on a line, copyright beneath.
Footer Centered
A centred brand, tagline, and navigation above a rule carrying copyright and policy links.