← Arcanum HollowDocs · 1.2.0

Expert match quiz

Configure weighted answer scoring and final result profiles for the Studio Arcana quiz section.

The Expert match quiz (lite) section now runs as a guided multi-step flow. Shoppers answer one question at a time, then receive one final recommendation based on weighted profile scoring.

Merchant setup in Theme Editor

  • Add the Expert match quiz (lite) section to the target template.
  • Create one or more Result profile blocks first. Each profile needs a unique profile key (recommended: lowercase_with_underscores).
  • Add Quiz question blocks and set each answer option label, profile key, and weight.
  • Each answer profile key must match an existing Result profile key exactly.
  • Optional per-profile fields: Why details, result CTA label, result CTA URL, Hollow Reserve staff ID (appends staff= on the booking handoff), and experience slug.

Scoring model and tie-break behavior

  • Each selected answer adds its numeric weight to the mapped profile key.
  • When the shopper finishes the last step, the highest total score wins.
  • Tie-breaks are deterministic: the result profile that appears first in block order wins.
  • If no profile can be resolved, the section shows a safe fallback summary.

Quiz completion analytics payload

  • Theme event: studio-arcana:quiz:complete
  • Payload includes question->answer map and ordered answer list.
  • Payload includes scoreMap and resolvedProfileKey.
  • Payload includes recommendation metadata (title, summary, why details, CTA data) when available.

Manual QA checklist

  • Only one step is visible at a time, with Back/Next controls and progress updates.
  • Next/Finish without an answer shows inline validation.
  • Finish renders exactly one result card with expected title and summary.
  • Retake quiz clears selected answers and returns to step 1.
  • Result CTA includes staff= when a Hollow Reserve staff ID is set on the winning profile.
  • Keyboard navigation and screen reader announcements remain usable.

Was this page helpful?

Content is maintained by Arcanum Hollow Labs. For internal engineering notes, see the docs/ folder in the monorepo.