How to control content visibility
Controlling when and how content is displayed is essential for creating personalized and accessible survey experiences. In Accessible Surveys, you can control visibility using three different methods, depending on whether you are targeting accessibility needs or respondent answers.
Method 1: Visibility Mode (Authoring Settings)
This is the most common method for showing or hiding entire Questions, Sections, or Pages based on the respondent's active accessibility mode (e.g., Easy Read, Sign Language).
When to use it
Use this when you want to provide a completely different version of a question or section for specific accessibility needs.
How to apply it
- Navigate to the Compose view.
- Select the item (Page, Section, or Question) in the tree grid.
- In the right-hand panel, click on the Settings (gear icon) or Visibility tab.
- Under "Make this field visible for", select or deselect the modes:
- Standard: Visible in the default survey view.
- Easy Read: Visible when the respondent activates Easy Read mode.
- Sign Language: Visible when the respondent activates Sign Language mode.
TIP
By default, all modes are selected, meaning the content is always visible.
Method 2: Markdown Block Directives & CSS Classes
If you need to show or hide specific paragraphs, components, or sentences within a single field (like an introduction page or a question label), use triple-colon block directives in the rich text editor.
When to use it
Use this for inline content variations where you want to swap a specific explanation or image depending on the respondent's active mode, without duplicating the entire question.
How to apply it
Wrap your content in a block directive:
::: show-when-easyread
This simplified explanation is visible only in Easy Read mode.
:::
::: hide-when-easyread
This standard text is hidden when Easy Read mode is active.
:::You can also apply class attributes to inline images or phrases using the {.class-name} syntax:
{.show-when-signlanguage}Refer to the Visibility Control Reference for the full list of available classes.
Method 3: Logical Expressions
Logical expressions allow you to show or hide content based on how a respondent has answered previous questions. This is often called "Skip Logic" or "Branching."
When to use it
Use this when visibility depends on data (e.g., "Only show the 'Childcare' section if the respondent answered 'Yes' to 'Do you have children?'").
How to apply it
- In the Compose view toolbar, activate Visibility Mode (eye icon).
- Select the item you want to hide.
- Click Create hidden logic.
- Write an expression that evaluates to
Truewhen the item should be hidden.
Example:
`Do you have children?` == `No`(This will hide the selected item if the respondent selects "No")
For detailed steps, see How to use form logic.
Summary: Which method should I choose?
| Method | Target | Based On | Best For |
|---|---|---|---|
| Visibility Mode | Entire Fields (questions, sections, or pages) | Accessibility Modes | Providing alternative versions of questions. |
| CSS Classes | Inline Content within a field (markdown text or label) | Accessibility Modes | Minor text adjustments within a single field. |
| Logical Expressions | Entire Fields (questions, sections, or pages) | Previous Answers | Personalizing the path through the survey (Skip logic). |