Skip to content
Sites

Map Quiz Results Directly to CRM Custom Fields

Automatically map quiz results to CRM contact fields for personalized automation, segmentation, and data-driven follow-ups.

4 min read860 words6 explained imagesUpdated Thu, 13 Nov, 2025 at 3:11 PM
View as markdownOpen in ClaudeOpen in ChatGPT
Each image has a one line explanation. Switch to full detail for the step it belongs to, the fields and buttons involved, examples and the whole procedure.
On this page
  1. Key Benefits of Quiz Result → CRM Field Mapping
  2. Auto-Generated Quiz Result Fields
  3. Default Data Types
  4. Real-Time Field Updates on Resubmission
  5. Using Quiz Result Fields in Workflows & Automations
  6. How To Setup Quiz Result → CRM Field Mapping
  7. Frequently Asked Questions
  8. Related Articles

Quiz Result → CRM Field Mapping allows quiz results to automatically populate into contact-level custom fields in your CRM. This gives you direct, structured access to quiz performance data for each contact which you can use for segmentation, personalization, and automation.


TABLE OF CONTENTS


What is Quiz Result → CRM Field Mapping?

Quiz Result → CRM Field Mapping writes a contact’s quiz outcomes, such as overall score and tier, per‑category scores and tiers, and highest/lowest category details, into contact custom fields in GHL Customer Care. Mapping turns one‑off quiz answers into durable CRM attributes.

This eliminates the need for manual tagging or external tracking tools. It turns every quiz submission into structured CRM data that you can use to create personalized experiences, trigger specific workflows, and segment contacts with precision.


Key Benefits of Quiz Result → CRM Field Mapping

  • Auto-Generated fields: Fields for overall score/tier, category scores/tiers, and highest/lowest category details are created for you.

  • Real‑Time Updates: The latest submission for the same quiz overwrites the same contact’s fields (no duplicates).

  • Automation-Ready: Use the mapped fields in workflows, branching, and conditional content.

  • Cleaner segmentation: Build smart lists based on scores, tiers, or winning categories.

  • Personalized Follow‑Ups: Tailor emails/SMS/pages based on outcome tiers or categories.


Auto-Generated Quiz Result Fields

GHL Customer Care scans the quiz on first submission and builds contact fields that follow a predictable naming pattern. This structure keeps data tidy and searchable. View the examples below:

  • {{quiz_name}} – Overall Score
  • {{quiz_name}} – Overall Score – Tier
  • {{quiz_name}} – {{category_name}} – Score

Default Data Types

  • Scores are stored as Number fields.
  • Tiers and Category Names are stored as Text fields.

This makes the data compatible with all standard CRM filters, workflow conditions, and personalization tools.


Real-Time Field Updates on Resubmission

Every time a contact retakes the same quiz, GHL Customer Care overwrites the existing values instead of creating duplicates. This ensures that automations always reference the latest scores without extra cleanup rules.


Using Quiz Result Fields in Workflows & Automations

Once quiz data is mapped into the CRM, you can use it in multiple ways:

1. Segment Contacts

Filter or group contacts based on their quiz performance.

Example:

  • Create a Smart List of users with “Overall Score ≥ 80.”
  • Group users by “Fitness Tier = Beginner” for targeted messages.

2. Personalize Automations

Use quiz results to tailor follow-up workflows.

Example:

  • Send different nurture emails depending on the highest or lowest category.
  • Trigger actions when a category score crosses a threshold.
2. Personalize Automations (image 1 of 6) What this shows Send different nurture emails depending on the highest or lowest category. What this shows Illustrates the "2. Personalize Automations" section of "Map Quiz Results Directly to CRM Custom Fields". This screenshot appears in the "2. Personalize Automations" section of "Map Quiz Results Directly to CRM Custom Fields". The text alongside this image reads: Send different nurture emails depending on the highest or lowest category. Trigger actions when a category score crosses a threshold. Immediately after, the guide continues: In workflows or campaigns, use mapped fields to create dynamic paths. Image 1 of 6 What this coversSend different nurture emails depending on the highest or lowest category. Trigger actions when a category score crosses a threshold. Next stepIn workflows or campaigns, use mapped fields to create dynamic paths.
All 2 steps in this procedure
  1. Send different nurture emails depending on the highest or lowest category.
  2. Trigger actions when a category score crosses a threshold.

3. Power Conditional Logic

In workflows or campaigns, use mapped fields to create dynamic paths.

Example:

  • If “{{quiz_name}} - Diet Tier = Advanced,” send an advanced guide.
  • If “{{quiz_name}} - Fitness Score < 50,” enroll the contact in a beginner plan.

How To Setup Quiz Result → CRM Field Mapping

Step 1: Open a Quiz

  • Navigate to Sites  → Quizzes.
  • Select an existing Quiz or click the blue + Add Quiz button to Create a new one.
Step 1: Open a Quiz (image 2 of 6) What this shows Navigate to Sites → Quizzes. What this shows Illustrates the "Step 1: Open a Quiz" section of "Map Quiz Results Directly to CRM Custom Fields". This screenshot appears in the "Step 1: Open a Quiz" section of "Map Quiz Results Directly to CRM Custom Fields". The text alongside this image reads: Navigate to Sites → Quizzes. Select an existing Quiz or click the blue + Add Quiz button to Create a new one. Immediately after, the guide continues: Scroll to the end of the quiz to the Re sults Template. Click on Edit Template. Image 2 of 6 Where to goNavigate to Sites → Quizzes. Select an existing Quiz or click the blue + Add Quiz button to Create a new one.
Buttons and menus referenced Sites→Quizzes+ Add Quiz
Next stepScroll to the end of the quiz to the Re sults Template. Click on Edit Template.
All 2 steps in this procedure
  1. Navigate to Sites → Quizzes.
  2. Select an existing Quiz or click the blue + Add Quiz button to Create a new one.

Step 2: Open Results Page 

Scroll to the end of the quiz to the Results Template. Click on Edit Template.

Step 2: Open Results Page (image 3 of 6) What this shows Scroll to the end of the quiz to the Re sults Template. What this shows Illustrates the "Step 2: Open Results Page" section of "Map Quiz Results Directly to CRM Custom Fields". This screenshot appears in the "Step 2: Open Results Page" section of "Map Quiz Results Directly to CRM Custom Fields". The text alongside this image reads: Scroll to the end of the quiz to the Re sults Template. Click on Edit Template. Immediately after, the guide continues: Click the Settings button in the upper right corner and expand the Custom Fields dropdown to see the automatically created custom fields. Under Custom Fields, turn on the toggles for the fields you want to sync, such as: The system will…. Image 3 of 6 What to clickScroll to the end of the quiz to the Re sults Template. Click on Edit Template.
Buttons and menus referenced Results TemplateEdit Template
Next stepClick the Settings button in the upper right corner and expand the Custom Fields dropdown to see the automatically created custom fields. Under Custom Fields, turn on the toggles for the fields you want to sync, such as: The system will automatically assign a Custom Field Name and Unique Key for each enabled field. Click Save once you’ve enabled the fields.

Step 3: Enable Custom Fields

  • Click the Settings button in the upper right corner and expand the Custom Fields dropdown to see the automatically created custom fields.
  • Under Custom Fields, turn on the toggles for the fields you want to sync, such as:

    • Overall Score

    • Overall Score Tier

    • Category-wise Scores and Tiers

    • Highest and Lowest Scoring Categories

  • The system will automatically assign a Custom Field Name and Unique Key for each enabled field.

  • Click Save once you’ve enabled the fields.

Step 3: Enable Custom Fields (image 4 of 6) What this shows Click the Settings button in the upper right corner and expand the Custom Fields dropdown to see the automatically created custom fields. What this shows Illustrates the "Step 3: Enable Custom Fields" section of "Map Quiz Results Directly to CRM Custom Fields". This screenshot appears in the "Step 3: Enable Custom Fields" section of "Map Quiz Results Directly to CRM Custom Fields". The text alongside this image reads: Click the Settings button in the upper right corner and expand the Custom Fields dropdown to see the automatically created custom fields. Under Custom Fields, turn on the toggles for the fields you want to sync, such as: The system will automatically assign a Custom Field Name and Unique Key for…. This part of the guide covers 4 fields, listed below. Immediately after, the guide continues: When a user completes a quiz, their scores and tiers are automatically captured. Image 4 of 6 What to chooseClick the Settings button in the upper right corner and expand the Custom Fields dropdown to see the automatically created custom fields. Under Custom Fields, turn on the toggles for the fields you want to sync, such as: The system will automatically assign a Custom Field Name and Unique Key for each enabled field. Click Save once you’ve enabled the fields.
Fields in this part of the guide Overall ScoreOverall Score TierCategory-wise Scores and TiersHighest and Lowest Scoring Categories
Buttons and menus referenced SettingsCustom FieldsCustom Field NameUnique KeySave
Next stepWhen a user completes a quiz, their scores and tiers are automatically captured.
All 4 steps in this procedure
  1. Click the Settings button in the upper right corner and expand the Custom Fields dropdown to see the automatically created custom fields.
  2. Under Custom Fields, turn on the toggles for the fields you want to sync, such as:
  3. The system will automatically assign a Custom Field Name and Unique Key for each enabled field.
  4. Click Save once you’ve enabled the fields.

Step 4: Contact Submits a Quiz

When a user completes a quiz, their scores and tiers are automatically captured.

Step 4: Contact Submits a Quiz (image 5 of 6) What this shows When a user completes a quiz, their scores and tiers are automatically captured. What this shows Illustrates the "Step 4: Contact Submits a Quiz" section of "Map Quiz Results Directly to CRM Custom Fields". This screenshot appears in the "Step 4: Contact Submits a Quiz" section of "Map Quiz Results Directly to CRM Custom Fields". The text alongside this image reads: When a user completes a quiz, their scores and tiers are automatically captured. Immediately after, the guide continues: After a quiz is submitted, the selected fields are created and updated in the contact record. Image 5 of 6 What this coversWhen a user completes a quiz, their scores and tiers are automatically captured. Next stepAfter a quiz is submitted, the selected fields are created and updated in the contact record.

Step 5: Data is Written to CRM Fields

After a quiz is submitted, the selected fields are created and updated in the contact record.

Example field names:

  • {{quiz_name}} - Overall Score
  • {{quiz_name}} - {{category_name}} - Tier
  • {{quiz_name}} - Highest Category - Score

If a contact retakes the same quiz, the existing data is overwritten — not duplicated. This keeps contact records clean and accurate.

Step 5: Data is Written to CRM Fields (image 6 of 6) What this shows If a contact retakes the same quiz, the existing data is overwritten — not duplicated. What this shows Illustrates the "Step 5: Data is Written to CRM Fields" section of "Map Quiz Results Directly to CRM Custom Fields". This screenshot appears in the "Step 5: Data is Written to CRM Fields" section of "Map Quiz Results Directly to CRM Custom Fields". The text alongside this image reads: If a contact retakes the same quiz, the existing data is overwritten — not duplicated. This keeps contact records clean and accurate. This part of the guide covers 3 fields, listed below. Immediately after, the guide continues: Q: Can I rename or delete the auto-generated fields? Image 6 of 6 What this coversIf a contact retakes the same quiz, the existing data is overwritten — not duplicated. This keeps contact records clean and accurate.
Fields in this part of the guide {{quiz_name}} - Overall Score{{quiz_name}} - {{category_name}} - Tier{{quiz_name}} - Highest Category - Score
Next stepQ: Can I rename or delete the auto-generated fields?
All 3 steps in this procedure
  1. {{quiz_name}} - Overall Score
  2. {{quiz_name}} - {{category_name}} - Tier
  3. {{quiz_name}} - Highest Category - Score

Frequently Asked Questions

Q: Can I rename or delete the auto-generated fields?

You can rename or move them into groups, but deleting a field removes historical quiz data from all contacts.

Q: Does the feature work with existing quizzes?

Yes, as long as the custom fields are toggled on within the quiz settings. Once a contact submits any quiz (new or old), GHL Customer Care creates the fields on the fly.

Q: Are these contact or opportunity fields?

They are Contact Custom Fields, making them usable in forms, Smart Lists, and contact workflows.

Q: Can I export quiz fields to CSV?

Absolutely! Exporting contacts includes every custom field, including quiz scores and tiers.


Was this guide helpful?

Related guides