Create conditional content blocks
Conditional blocks are sections of content that appear or disappear based on the Publication target settings condition profile.
Before you begin
Set up conditions — you need at least one dimension 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 condition button in the toolbar.
Choose a dimension (e.g., "Audience").
Select one or more values (e.g., "Admin").
The content is wrapped in a colored block showing the dimension name and selected values.
You can also use the Editor slash commands /condition to wrap selected content. This is faster than using the toolbar button if you're already typing.
How conditional blocks render
In the editor: Conditional blocks show a colored border and a label (e.g., "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, it's removed.
A condition profile is a JSON structure that specifies which values to include per dimension:
{
"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.
Add multiple conditions to the same content
Select the conditional block and add another condition to narrow the audience further. Content can be conditioned on multiple dimensions — for example, "Audience: Admin" AND "Platform: Windows."
When a block has multiple conditions, the target's condition profile must match all of them for the block to appear. This is an AND relationship, not OR.
To show the same content to multiple values within a single dimension (e.g., both Admin and Developer), select multiple values in that dimension rather than adding separate conditions.
Remove a condition
Click the condition label on the block and deselect values, or remove the entire condition. The content remains — only the conditional wrapping is removed.
See also
Set up conditions — create the dimensions and values used in conditional blocks
Preview conditioned content — verify conditional blocks before publishing
Conditions vs. 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