Who This Is For / When to Use
Users who want quiz results stored directly on contact records
Teams building automations or workflows based on quiz performance
Accounts using quizzes for segmentation, personalization, or qualification
What Quiz Result Field Mapping Does
When a quiz is submitted, Kyrios can automatically create and update contact custom fields with quiz results.
This removes the need for manual tagging or third-party integrations.
Auto-Generated Quiz Result Fields
On the first quiz submission, Kyrios scans the quiz and creates structured custom fields.
Generated fields include:
Overall Score
Overall Score Tier
Category Scores
Category Score Tiers
Highest Scoring Category
Lowest Scoring Category
Default field types:
Scores: Number fields
Tiers and category names: Text fields
Field naming pattern:
{{quiz_name}} - Overall Score{{quiz_name}} - Overall Score - Tier{{quiz_name}} - {{category_name}} - Score
Real-Time Updates on Resubmission
If a contact retakes the same quiz:
Existing quiz fields are overwritten
No duplicate fields are created
Contact records remain clean and current
Step 1: Open a Quiz
Navigate to Sites > Quizzes.
Click Add Quiz or open an existing quiz.
Step 2: Open the Result Template
Scroll to the bottom of the quiz builder.
Click Edit Template under Result Template.
Step 3: Enable Quiz Result Custom Fields
Custom field mapping is controlled from the result page settings.
Enable Fields
Click Settings (top-right).
Expand Custom Fields.
Toggle on the fields you want to sync:
Overall Score
Overall Score Tier
Category Scores
Category Score Tiers
Highest Scoring Category
Lowest Scoring Category
Review the auto-generated Custom Field Name and Unique Key.
Click Save.
Step 4: Contact Submits the Quiz
When a user completes the quiz:
Scores and tiers are calculated
Enabled custom fields are populated automatically
No additional configuration is required.
Step 5: View Quiz Data on the Contact Record
Quiz fields appear directly on the contact profile.
Where to Find Them
Open a contact record
Scroll to the quiz section
View scores, tiers, and category results
Step 6: Quiz Submission Activity Tracking
Each quiz submission is logged as an activity.
This includes:
Quiz name
Submission source
Timestamp
Using Quiz Result Fields in Workflows and Automations
Quiz result fields behave like standard contact fields.
Common Use Cases
Segment contacts by score or tier
Trigger workflows based on category performance
Personalize emails, SMS, or campaigns
Examples
If Overall Score ≥ 80, send advanced offer
If Fitness Score < 50, enroll in beginner sequence
If Highest Category = Strength, tag as strength-focused
Common Issues and Fixes
Fields are not appearing on the contact
Confirm the toggles were enabled before quiz submission
Submit a test quiz to initialize field creation
Duplicate fields appear
This occurs only if quiz names were changed
Use consistent quiz naming to avoid confusion
FAQ
Will a new field be created for every quiz submission?
No. Custom fields are created once per quiz and updated on each resubmission.
Are quiz fields updated in real time?
Yes. Fields are written to the contact record immediately after submission.
Can I use quiz fields in workflows?
Yes. Quiz fields can be used as triggers, filters, and conditions in workflows.
Can I rename quiz custom fields?
Yes. Field labels can be edited, but the system uses a standard naming pattern by default.
What happens if I add new categories later?
New category fields are automatically generated on the next quiz submission.