PageForge 1.3: check every run before it writes, update generated pages, spintax and resumable batches. See what changed
Account Get it free

Vary wording between pages with groups such as {Fast|Quick|Reliable}. Each page keeps its wording on every re-run and update.

Since 1.3.0 Updated November 18, 20263 min read

Spintax lets one template produce slightly different wording on each page. You write a group of alternatives in curly braces, separated by a pipe, and each page picks one of them.

Spintax picks one wording per page and keeps it on every re-run.

The syntax

{Fast|Quick|Reliable} {Service} in {City}.

One page gets “Fast Roof Repair in Austin.”, another “Reliable Roof Repair in Dallas.” A group needs at least one pipe character. Without a pipe, {City} is a normal placeholder, so the two never clash.

Nested groups

Groups can sit inside other groups. PageForge resolves the inner group first:

{Licensed|{Fully|Properly} insured} roofers serving {City}.

Possible results include “Licensed roofers serving Austin” and “Fully insured roofers serving Austin”.

Wording stays the same on re-runs

Each page’s choice is tied to its URL. Re-running the campaign, or updating pages after a CSV change, gives each page the same wording it had before, as long as the spintax text in the template is unchanged. If you edit a group’s options, pages using that group may pick differently on the next update.

Where spintax works

  • The template content, and the content of a layout chosen in Base Layout to Clone, including builder data such as Elementor widgets
  • The Title Pattern
  • The Meta Description Pattern
  • The excerpt

It does not work in the Slug Pattern. URLs come from your columns only, so they stay predictable.

What spintax leaves alone

PageForge skips code and settings that use braces and pipes for other reasons:

  • Anything inside script and style elements
  • Block settings and builder data that contain quotes or braces, such as Gutenberg block attributes and JSON

Because of the second rule, keep each option to plain text. An option that contains a double quote, a line break or another set of braces that is not a spintax group is left exactly as typed.

Spintax and placeholders

Spintax is resolved before placeholders are filled. Keep {Column} placeholders outside spintax groups:

Works:        {Call|Ring} us on {Phone} today.
Does not work: {Call us on {Phone}|Ring us today}

In the second line the group contains a placeholder, so it is not treated as spintax and the braces stay on the page.

A realistic example

A template for a dental group’s location pages:

{Book|Schedule|Request} your {appointment|visit} at our {City} office.
Our {friendly|experienced} team offers {Service} {with flexible hours|six days a week}.

Use it in moderation

Spintax changes how a sentence is phrased. It does not add information. Two pages that differ only in synonyms are still the same page to a reader. Use spintax to avoid identical boilerplate across many pages, and use your data for what makes each page useful: local details, prices, opening hours, team names and customer quotes.

Check and preview shows the first page’s title with spintax already applied, so you can confirm groups in the Title Pattern work before anything is written.

Tip Test spintax on three to five draft pages first. Read them side by side and check that every combination makes a grammatical sentence.

Next: Pages, posts, custom post types and URLs.

Was this page helpful?

↑↓ to move↵ to open