Questionnaire Display Conditions

Last updated: 16 April 2026

Questionnaire Display Conditions

When you attach a questionnaire to an appointment type, you can set conditions that control whether the questionnaire is shown to a specific patient. This prevents patients from seeing irrelevant or redundant forms.

How to Set Conditions

  1. Navigate to Configuration > Appointment Types and select an appointment type
  2. Open the Questionnaires tab
  3. Click the conditions icon on any attached questionnaire
  4. Configure the conditions you need

Available Conditions

Condition What it does
Skip if previously completed Hides the questionnaire if the patient has already submitted a response to this template. Useful for one-time intake forms.
First visit only Only shows the questionnaire if the patient has no prior consultations. Useful for new patient registration forms.
Maximum completions Limits how many times the questionnaire can be shown to a patient. Once the limit is reached, the form is hidden.
Gender Only shows to patients matching the specified gender (Male, Female, or Any). Useful for gender-specific screening.
Age range Only shows to patients within the specified minimum and maximum age, calculated from their date of birth. Useful for age-appropriate assessments.

How Conditions Are Evaluated

Conditions are checked when the patient starts the booking flow. All conditions on a questionnaire must be met for it to appear. If any condition is not met, the questionnaire is silently hidden - the patient does not see a message about it.

Conditions are evaluated both on the client (for a smooth booking experience) and on the server (for security).

Examples

  • New patient intake form: Set "First visit only" so returning patients skip it
  • Annual health check: Set "Skip if previously completed" and attach to annual review appointment types
  • Cervical screening questionnaire: Set Gender to "Female" and Age range to 25-64
  • Paediatric development questionnaire: Set Age range to 0-5

Tip: Combine conditions to be precise. For example, a menopause symptom questionnaire could use Gender = Female and Age range = 45-60 together.