Variables Library

Variables Library gives you a centralized view of custom variables across all quizzes in your workspace.

What you can do

• Search variables by key, type, description, quiz title, or usage path.
• Filter by quiz to isolate definitions and usages.
• Create a new variable definition in a selected quiz.
• Edit existing definitions (type, description, defaults, enum options).
• Rename a variable key across references.
• Archive or restore variables.
• Delete unused variables (single or bulk).

Where to find it

Open Dashboard > Variables from the left navigation.

How usage indexing works

The library scans quiz definitions and records where each variable appears:

• Explicit mappings (for example save-to-variable fields, completion rule variable keys, and bio action intent keys)
• Placeholder usage inside copy (for example {{customer_segment}})
• Variable definitions stored under quiz variable metadata

Each variable entry shows:

• Definition count
• Usage count
• Quizzes impacted
• Usage category labels (response mapping, completion rule, bio action, placeholder)

Archive vs delete

• Archive hides a variable from normal pickers while preserving existing references.
• Restore brings an archived variable back to active pickers.
• Delete is only allowed when no usages are detected.

Use archive when you are deprecating a variable but still need historical compatibility.

Rename behavior

When you rename a variable key, the system updates:

• Explicit key fields where variable keys are stored
• Placeholder tokens in copy ({{old_key}} -> {{new_key}})

Renaming is blocked if the target key already exists.

Tips

• Use stable lowercase keys with underscores (for example high_intent, lead_tier).
• Prefer archive before delete in active production quizzes.
• Review usages before changing enum options to avoid invalid downstream assumptions.