Show or hide questions based on inputs

When creating programs, some application questions might not need to be displayed when based on the answers to previous questions. For example, if an Applicant’s date of birth is earlier than the qualifying year, a screen displaying a discount code for older adults is unnecessary.

Using a visibility condition, CiviForm Admins can easily show or hide a screen based on the answer to any question within the program.

Important: If you create a visibility condition based on a question that’s potentially hidden behind a different visibility condition, unexpected behaviors might occur.

Add a visibility condition

1. Sign in to CiviForm as a CiviForm Admin.

2. Click Programs on the navigation bar.

3. Click Edit for the program you would like to add a condition for.

4. Select a screen you wish to show or hide and click Edit visibility condition.

5. On the Visibility Condition page, under New visibility condition, select the questions you would like to use for your condition and then click Add condition.

6. In the Configure Visiblity Conditions page select if the screen should be either hidden if or shown if.

7. For each question in your condition:

   1. Set the Field data type.

   2. Set the Operator value.

   3. Enter the Value.

   4. Click Submit.

8. The visibility condition is displayed on both the Visibility Condition page and the screen. For example, “Screen 3 is hidden if household size question name Number is less than 2."

Multiple allowable values can be specified for a given set of questions in a condition. For example, if a condition uses two questions, household size (number) and household income (currency), multiple combinations of household size and income pairings can be specified that meet the condition. To add additional value groups, click +Add values on the Configure Visiblity Conditions page and fill in the additional values.

Edit a visibility condition

1. Sign in to CiviForm as a CiviForm Admin.

2. Click Programs on the navigation bar.

3. Click Edit for the program you would like to add a condition for.

4. Select a screen you wish to show or hide and click Edit visibility condition.

5. Click Edit existing visibility condition.

6. Follow steps in "Add a visibility condition" for configuring the condition.

Remove a visibility condition

1. Sign in to CiviForm as a CiviForm Admin.

2. Click Programs on the navigation bar and select a program.

3. Select a screen with a visibility condition and click Edit visibility condition.

4. Click Remove condition visibility condition.

5. Click Return to edit screen #.

6. The visibility condition is removed from both the Visibility Condition page and to the screen. The default statement “This screen is always shown" is displayed on the page.

Rules for visibility conditions

The following rules apply when trying to understand visibility conditions:

• There can only be one visibility condition per screen.

• You can only add a visibility condition for questions used in previous screens. For example, adding a date question to Screen 2 means it’s available for selection in Screen 3. Questions in Screen 3 are not available for selection.

• When using a text field, the value should not be in quotes.

• When using the operators "is one of" or "is not one of" on text values, the text should be in a comma-separated list. For example, blue,green,purple. The visibility condition fires if the answer to the question is blue or green or purple.