Conditional content

Conditional content blocks let you control who can see a given block of content on your page based on user data and variables. These variables can be passed in via cookies, feature flags, authenticated access, or URL parameters.

Create conditional content

To add a conditional block, begin a new line in the editor, type /, then select Conditional content.

After inserting the block, click the red condition badge in the top right of the block.

Clicking this will allow you to add a condition through the condition editor. You’ll be able to write your condition as an expression that will run against data defined in your site. You can reference data from variables, or data coming from visitors through their claims.

See adaptive content for more details.

Example

The examples below use a URL parameter linked from the button to control which conditional content block is visible.

This block is only visible to users without attribute A.

View with attribute A

Representation in Markdown

## Example

{% if visitor.claims.unsigned.example_attribute_A %}
This block is only visible to users **with** attribute A.
<a href="https://gitbook.com/docs/creating-content/blocks/conditional-content?visitor.example_attribute_A=false" class="button primary">View without attribute A</a>
{% endif %}

{% if !visitor.claims.unsigned.example_attribute_A %}
This block is only visible to users **without** attribute A.
<a href="https://gitbook.com/docs/creating-content/blocks/conditional-content?visitor.example_attribute_A=true" class="button primary">View with attribute A</a>
{% endif %}