Create conditional content blocks
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.
Conditional blocks are sections of content that appear or disappear based on the Publication target settings condition profile.
Before you begin
Set up filters: you need at least one filter group with values before you can apply conditions to content.
Wrap content in a condition
Open a topic in the editor.
Write the content that should be conditional.
Select the content: one or more paragraphs, lists, tables, or any block elements.
Click the filter icon ("Wrap in condition") in the editor toolbar.
In the Wrap in condition dialog, choose a filter group (for example, "Audience").
Select one or more values (for example, "Admin").
Click Apply Condition. The editor wraps the content in a bordered block showing the group name and selected values.
If no filters exist yet, the dialog shows an Add filters in Configure link. See Set up filters.
How conditional blocks render
In the editor: Conditional blocks show a colored border and a label (for example, "Audience: Admin"). The content is always visible.
On the published site: The The publishing pipeline checks the target's condition profile. If the profile includes "Audience: Admin," the block appears. If not, the pipeline removes it.
A condition profile is a JSON structure that specifies which values to include for each filter group:
{
"Audience": ["Admin"],
"Platform": ["Web", "Mobile"]
}If a publication target has no condition profile set, all conditional blocks are excluded by default. Always assign a condition profile to every target that publishes conditioned content.
Nest conditions to narrow the audience
To require more than one filter value, nest one conditional block inside another. Select content inside an existing block and wrap it in a second condition, for example, an "Audience: Admin" block containing a "Platform: Windows" block. The target's condition profile must match both for the inner content to appear. This is an AND relationship, not OR.
To show the same content to multiple values within a single filter group (for example, both Admin and Developer), select multiple values in the Wrap in condition dialog. Nesting blocks creates an AND relationship, which is not what you want here.
Boolean expression builder
Condition profiles are not limited to simple value lists. In the publish manager, the visual condition builder lets you construct expression trees using AND, OR, and NOT operators, for example, (Platform = "Windows" AND Audience = "Admin") OR NOT Feature = "Deprecated". You can add conditions, toggle between AND/OR, and wrap groups in NOT.
Remove a condition
Click Remove in the block header to delete the conditional wrapper. This removes the block and its content, so cut any content you want to keep before removing the wrapper, or drag it out of the block first.
See also
Set up filters: create the filter groups and values used in conditional blocks
Preview conditioned content: verify conditional blocks before publishing
Conditions versus variables: when to use conditions versus variable tokens
The publishing pipeline: how conditional blocks are processed during publish
Troubleshooting: common issues with conditions and variables