Step by Step

A numbered process grid with connected step counters.

Usage

Step by Step displays a numbered process as a responsive grid of steps β€” each with a circular counter, headline, and description. Use it for onboarding flows, how-it-works sections, service steps, or any sequence where order matters.

The block inserts with four Step children by default. Steps auto-number via CSS counters; you control the look with parent settings rather than typing numbers manually.

Parent and child blocks

The Step by Step parent holds one or more Step children (ds/step-by-step-child). Add or remove steps with the block inserter.

Select Step by Step for layout, counter styling, and connector options. Select an individual Step child to edit that step's title and body copy.

Layout (parent)

  • Columns β€” 2, 3, 4 (default), 5, or 6 steps per row. The grid wraps responsively on smaller screens.
  • Alignment β€” Left or Center for counter, headline, and body text within each step
  • Grid Gap β€” spacing between steps in rem (0–4)
  • Small Text β€” reduces body copy size for every step
  • Card Background β€” adds a subtle rounded background pad around each step's content
  • Connector Line β€” horizontal lines linking step counters on desktop (768px and up)
    • Connector Width β€” line thickness in pixels (1–24)
    • Connector Color β€” palette color for the connector

Connectors hide on the last step and are not shown on mobile.

Headlines (parent)

  • Headline Tag β€” semantic HTML tag for step titles on the front end (h2–h6 or p; default h4)
  • Headline Appearance β€” Customizer typography preset for how titles look (default matches h5)

Tag and appearance are independent β€” you can use an h4 tag with a smaller visual style, for example.

Counter (parent)

Shared styling for every step's numbered circle:

  • Counter Appearance β€” typography preset for the number
  • Counter Text Color, Counter Outline Color, Counter Background β€” palette colors
  • Counter Outline Width β€” border thickness in pixels (0–12)
  • Counter Size β€” circle diameter on a 4–40 scale (maps to about 1–10rem)
  • Counter Font Size Adjust β€” fine-tune number size in em (0.5–9)
  • Counter Prefix β€” text before the number (default 0 produces 01, 02, 03…)
  • Counter Suffix β€” text after the number (e.g. . for 1.)

Individual steps (child)

Select a Step child to configure:

  • Title β€” step headline, edited inline
  • Body β€” paragraph inner blocks below the title (default template includes one paragraph)

Counter numbers update automatically when you reorder, add, or remove steps.

Block width

Step by Step supports Wide and Full alignment from the block toolbar and defaults to Wide width.

Tips

  • Set Columns to match your step count when possible β€” four steps in four columns reads cleaner than three plus one wrapped.
  • Use Counter Prefix 0 for zero-padded numbers (01, 02) or clear the prefix for plain 1, 2, 3.
  • Enable Card Background when steps sit on a busy Section background.
  • For chronological events with dates rather than numbered steps, consider Timeline instead.

Settings

Step by Step Settings

Columns setting in the block editor sidebar
Columns

Steps per row β€” 2, 3, 4, 5, or 6. The grid wraps on smaller viewports.

  • 2
  • 3
  • 4default
  • 5
  • 6
Headline Tag setting in the block editor sidebar
Headline Tag

Semantic HTML tag for step titles on the front end β€” h2 through h6 or p.

  • <h2>
  • <h3>
  • <h4>default
  • <h5>
  • <h6>
  • <p>
Headline Appearance setting in the block editor sidebar
Headline Appearance

Customizer typography preset for step title appearance. Independent of Headline Tag.

  • <h3>
  • <h4>
  • <h5>default
  • <h6>
  • <p>
  • <strong>
Alignment setting in the block editor sidebar
Alignment

Align counter, title, and body text left or center within each step.

  • Left
  • Centerdefault
Small Text setting in the block editor sidebar
Small Text

When enabled, renders step body copy at a smaller size.

Card Background setting in the block editor sidebar
Card Background

Adds a subtle rounded background pad around each step's content.

Connector Line setting in the block editor sidebar
Connector Line

Draws horizontal lines between step counters on desktop (768px and up). Hidden on the last step.

Connector Width setting in the block editor sidebar
Connector WidthShown when Connector Line is enabled.

Thickness of the connector line in pixels (1–24).

Connector Color setting in the block editor sidebar
Connector ColorShown when Connector Line is enabled.

Palette color for the connector line.

Grid Gap setting in the block editor sidebar
Grid Gap

Spacing between steps in rem units (0–4).

Counter

Counter Appearance setting in the block editor sidebar
Counter Appearance

Customizer typography preset for the number inside the counter circle.

  • <h1>
  • <h2>
  • <h3>
  • <h4>default
  • <h5>
  • <h6>
  • <p>
  • <strong>
Counter Text Color setting in the block editor sidebar
Counter Text Color

Color of the counter number.

Counter Outline Color setting in the block editor sidebar
Counter Outline Color

Border color of the counter circle.

Counter Background setting in the block editor sidebar
Counter Background

Background fill of the counter circle.

Counter Outline Width setting in the block editor sidebar
Counter Outline Width

Border thickness of the counter circle in pixels (0–12).

Counter Size setting in the block editor sidebar
Counter Size

Counter circle diameter on a 4–40 scale (about 1–10rem). Default 14 is about 3.5rem.

Counter Font Size Adjust setting in the block editor sidebar
Counter Font Size Adjust

Fine-tune counter number font size in em units (0.5–9).

Counter Prefix setting in the block editor sidebar
Counter Prefix

Text before the auto-incremented number. Default 0 produces zero-padded numbers (01, 02…).

Counter Suffix setting in the block editor sidebar
Counter Suffix

Text after the counter number, such as a period.