Documentation

Personalization

One page, personal to every visitor. Define audiences once, override any field per variant, and serve the right version by country, device, UTM, cookie — any condition you choose.

Audiences & variants

Configure your space's audiences in Settings → Space → Personalization. An audience groups related variants — for example a Device group with Mobile and Desktop, or a Source group with Newsletter and Product Hunt. Groups can be single-choice or allow multiple active variants at once.

Overriding fields per variant

In the entry editor, the Default layer is what everyone sees. Select a variant and edit any field to create an override — only the changed fields are stored, layered on top of the default. Overrides publish together with the entry, so drafts of a variant never leak.

Previewing variants

The editor's visual preview renders your real site with the selected variants applied, so you can flip between Mobile × Newsletter and Desktop × Product Hunt and see exactly what each visitor gets — before publishing.

Serving personalized content

Your site decides which variants a visitor matches (from geo, device, UTM params, cookies…), then either:

  • Passes them to the API with ?variants=a,b and receives merged data, or
  • Fetches the raw override layer + audience catalog and resolves client-side.

Request/response details in the API Reference → Personalization.