questionnaire docs
User Flows

Questionnaire Theme

User flow for the default questionnaire modal theme.

Questionnaire Theme

Component: components/questionnaire/QuestionnaireModal.js Default theme — used when category.questionnaireType is questionnaire or unset.

User flow

What the user sees

  1. Overlay modal — covers the category content
  2. Progress indicator — shows current step
  3. Questions — multiple choice with 2-4 options per step
  4. No ads during questions — intermediate steps have no CTAs or ads
  5. Final step CTA — "Watch Ad to Continue" shimmer button
  6. Rewarded ad — full-screen video ad
  7. Content reveal — modal closes, category sections visible

Question routing

Each question option can have a targetCategorySlug. Selecting an option may navigate to a different category.

Ad behavior

Ad typeWhen it starts
DisplayTheme visible
InterstitialTheme visible
RewardedTheme visible (loads), CTA triggers play
SkyscraperTheme closed
StickyRewarded CTA click

Questionnaire-page variant

A two-phase flow (questionnaire-page type) shows the questionnaire as a full page, then redirects to ?unlocked=1. Currently disabled via QUESTIONNAIRE_PAGE_FLOW_ENABLED = false.

On this page