Skip to content

Preview conditioned content

This feature requires the Enterprise capability tier (the Business ). During the beta, every project is on the free Solo tier, so this feature is locked by default: go to Settings ▸ Billing and request Enterprise access to unlock it.

Condition preview lets you see exactly what a specific audience will see, without publishing.

Before you begin

Open condition preview

  1. Open a topic that contains conditional blocks.

  2. Click the eye icon ("Preview with conditions") on the right side of the editor toolbar.

  3. The preview replaces the editing view, showing the available filter groups and values as toggle chips above a read-only rendering of the topic.

Click the eye icon again at any time to leave preview and return to editing. Toggle it as you write conditioned content to check each audience as you go.

Select a preview profile

  1. For each filter group, select the values you want to preview.

    • Example: Audience = "Admin," Platform = "macOS."

  2. The editor updates to show only the content that matches your selection.

  3. Conditional blocks that do not match are hidden.

This simulates the Publication target settings that a publication target would use. The preview applies the same filtering logic as the The publishing pipeline.

Condition preview also resolves Use variable tokens in content and inlines How component reuse works, using your project's default variable set. Turn the Show resolved sources toggle off for a true reader view, or leave it on to highlight which text came from a variable or component. To preview a different variable set or per-target overrides, publish to a draft target instead.

Switch between profiles

Change the selected values to preview different audience combinations. The editor updates in real time, letting you quickly verify that each audience sees the right content.

Things to check when switching profiles:

  • No content is accidentally visible to the wrong audience

  • Hiding a conditioned block does not leave awkward transitions or disjointed prose

  • All audiences see a complete, coherent topic, not just fragments

Close preview

Click the eye icon again to exit preview mode and return to the full editing view where all conditional blocks are visible.

Edits made during preview mode apply to the underlying topic, not to a specific audience. If you add or modify text while preview is active, the changes affect the topic for all audiences.

See also

Was this page helpful?