Skip to content
Birdhouse

Create a Dependent Questionnaire

Dependent questionnaires collect information for additional insured persons — such as a partner or child — on an existing policy. They are separate questionnaires linked to the same vertical, synced into a dependents/ subdirectory.

Prerequisites

Section titled “Prerequisites”
  • A main (non-dependent) questionnaire already exists for the vertical
  • The vertical supports dependent coverage

Steps

Section titled “Steps”

1. Create the questionnaire in Strapi

Section titled “1. Create the questionnaire in Strapi”

Create a new questionnaire entry in Strapi. Give it a descriptive name (e.g., expat-eu-dependents) and set the slug to match the main questionnaire’s slug (e.g., expat-eu).

2. Set isDependent to true

Section titled “2. Set isDependent to true”

In the questionnaire metadata, set isDependent to true. This is the key flag that tells the sync script to output the file into the dependents/ subdirectory.

Field Value
isDependent true
type Same as the main questionnaire (singleRegion, multiRegion, etc.)
slug Same slug as the main questionnaire

3. Configure dependent-specific questions

Section titled “3. Configure dependent-specific questions”

Dependent questionnaires typically collect:

  • Dependent’s personal information (name, date of birth)
  • Relationship to the primary policyholder
  • Any dependent-specific eligibility checks

You do not need to repeat questions already answered in the main questionnaire (e.g., region selection, start date).

4. Understand the sync output

Section titled “4. Understand the sync output”

When synced, dependent questionnaires are placed in a dependents/ subdirectory:

src/syncedData/questionnaires/
  expat-eu.ts                  ← main questionnaire
  dependents/
    expat-eu.ts                ← dependent questionnaire

5. Translation key behavior

Section titled “5. Translation key behavior”

Dependent questionnaires use the same translationKey as the main questionnaire, but translation lookups automatically receive a .dependents prefix. This allows you to customize text for the dependent flow without affecting the main questionnaire.

Example:

  • Main: questionnaire.expatEu.preQuote.intro.screen.question
  • Dependent: questionnaire.expatEu.dependents.preQuote.intro.screen.question

When to use dependents vs variants vs separate questionnaires

Section titled “When to use dependents vs variants vs separate questionnaires”
Scenario Use
Same product, different provider (AOK vs TK) Variants
Additional person on an existing policy Dependent questionnaire
Completely different product or eligibility Separate questionnaire

See also

Section titled “See also”