Skip to content

Explore Alternatives and Compare

Explore lets you try prepared alternatives, such as two headlines or several accent colors, on a draft. Compare shows up to four views of the same page so you can inspect different combinations, page drafts, site versions, or the live site together.

Explore and Compare are available in Bricks 2.5 with Enable drafts turned on under Bricks → Settings → Builder. Drafts are experimental and disabled by default.

You need an active draft or site version that your account can edit. The Explore alternatives entry appears only when that version already contains alternatives. Compare with live works without alternatives.

Alternative groups are currently created through Bricks abilities, for example by a connected AI assistant using bricks/create-alternatives. The Builder provides the interface for previewing and applying those groups; it does not have controls for creating groups or writing their choices manually.

Each group represents one decision, such as Headline or Accent color. Each choice contains proposed changes to existing element settings, global class settings, or variable values. You can select one choice per group and combine choices from different groups.

For example, ask a connected assistant:

In the page’s draft, prepare two headline alternatives and two accent-color alternatives. Keep the existing elements. Put headlines and colors in separate groups so I can mix them, and give me the Explore and Compare links.

The assistant can use an existing page draft, create one if needed, or work in a specified site version. Preparing alternatives saves the options for review without applying their proposed changes.

While editing a draft or site version, open the version menu beside Save:

  • Choose Explore alternatives to preview its groups in one view.
  • Choose Compare with live to open the version and live page together.

These views open over the Builder. If the current draft has unsaved edits, Bricks saves them into the draft before opening the view. Click Close to return to editing.

In Manage versions, select a version and click Compare. An editor can also open an Explore or Compare link returned by the connected assistant. These editor links require a login and permission to edit the version; use a review link for someone without an account.

The compact draft menu with Publish, Discard, Compare with live, and Explore alternatives.

The options panel shows the active view’s groups. Select a choice under each group you want to change. Choose As drafted to show that group’s current saved draft values without an alternative applied.

For example, select the second Headline and the first Accent color. The page preview shows that combination. Switching choices previews their effect without saving those choices to the draft or publishing them.

Explore showing independent Headline and Accent color groups with Room to grow and Terracotta selected.

If a view has no alternative groups, the options panel is hidden. You can still compare its page with another view.

Click Add view to copy the active view and its current choices. Then use the version selector in each view’s header to choose the page’s Draft, an available named site version, or Live site.

Click a view’s header to make it active. Its border is highlighted, and the options panel changes to the groups belonging to that view’s version. Each view keeps its own combination. Changing one view’s version clears its previous alternative selections.

For example, compare:

ViewVersionAlternatives
1Live siteCurrent published page
2Autumn servicesClear direction headline, Forest accent
3Autumn servicesRoom to grow headline, Terracotta accent

The selectors offer drafts and site versions you can edit. A page draft belongs to its own page; another page’s draft is not offered for this comparison. Site versions show the current page within that version.

Live site compared with two Autumn services combinations, with the third view active and its own choices shown.

Up to four views are supported. Use Expand to inspect one at a larger size, then Show all views to return. The × button removes a view from the comparison without deleting its draft or site version.

The breakpoint buttons use the site’s configured Bricks breakpoints. Choosing a width changes every view together. Each page renders at that width and scales down to fit its available space, so a desktop page can remain a desktop preview inside a narrow comparison pane.

Scroll one page view to move the others to the same vertical position. Switching alternative choices keeps the view’s scroll position where the new content allows it. Pages with different heights may not line up exactly.

Select the view containing the combination you want, then click Apply to draft. Bricks applies that view’s selected choices to its own draft or site version. Groups left on As drafted keep their current values. Applying requires the same permissions as editing the affected page, classes, or variables directly.

Applying does not publish the page. Close the view to return to the Builder. If you applied choices to a different site version, select that version in the toolbar to continue editing it. Use the draft or site version’s publishing workflow when it is ready.

Shared classes and variables follow the drafts shared-data rules: changes affecting live content stay in the draft until publication. Updates that do not affect live content are shared across the site immediately, ready to use on other pages and templates. Applying alternatives uses the same rules.

After applying, As drafted shows the updated draft. Selecting it does not undo a combination you already applied. If Bricks reports that the alternatives changed since you opened them, reload the view and review the current choices before applying again.

With review links enabled, you can share a draft or site version with someone who does not have a WordPress login. When it contains alternatives, the review panel includes Explore alternatives.

Reviewers can switch options and add views to inspect combinations within the shared version. Their view has no version selector and no Apply to draft button. They cannot publish, save a preferred combination, or submit comments through the review link. Ask them to send their feedback separately.

For recovering an earlier saved class, variable, component, or other shared item, use Global data history.