Skip to content

Set up conditions

Conditions define the dimensions along which your content varies — audience, platform, product tier, or any axis relevant to your documentation.

Create a dimension

  1. Go to Filters in the sidebar.

  2. Click New Dimension.

  3. Enter a name — e.g., "Audience," "Platform," or "Product."

Add values to a dimension

  1. Open the dimension.

  2. Add values — e.g., for "Audience": "Admin," "Developer," "End User."

  3. Each value gets an automatically assigned color that appears in the editor.

Choose dimension names that describe the axis of variation, not specific values. "Audience" is better than "Admin vs. User" because it accommodates future values like "Developer" without renaming the dimension.

Plan your dimensions

Before creating conditions, decide which axes of variation your documentation needs:

Dimension

Example values

Use when

Audience

Admin, Developer, End User

Different roles see different features

Platform

Windows, macOS, Linux

OS-specific instructions

Product

Free, Pro, Enterprise

Tier-specific capabilities

Version

v2, v3

Version-specific content

Keep dimensions to a minimum. Each additional dimension multiplies the number of output variants you manage.

Adding a new dimension multiplies your output matrix. Two dimensions with 3 values each means up to 9 possible combinations. Before adding a third dimension, verify you actually need separate Publication target settings for those combinations.

A Publication target settings selects one or more values per dimension. For example, a target might use this profile:

{
  "Audience": ["Admin"],
  "Platform": ["Web", "Mobile"]
}

This target includes content conditioned for Admin audience and content conditioned for Web or Mobile platforms.

Edit or delete conditions

  • Rename a dimension or value by clicking its name.

  • Delete a value to remove it. If content uses that value in conditional blocks, the Content health and governance system flags it as a stale condition.

  • Delete a dimension to remove it and all its values.

Deleting a dimension removes it from all existing conditional blocks across your project. Those blocks lose their condition and become unconditionally visible — meaning previously hidden content may appear in all outputs. Always check which topics use a dimension before deleting it.

See also

Was this page helpful?