Automate Quiz Completions with Shopify Flow

Shopify Flow can run an automation every time a customer completes your quiz. Follow up, segment, or update your store based on the answers.

How the workflow starts depends on your version of the app. The Built for Shopify version has a Quiz Completed trigger that carries the whole completion. Your actions can use the response, answers, customer tags, recommendations and variable scores. On the legacy version you build the same automation on Shopify's Customer created trigger, with a condition on customer tags.

ShopifyShopify (Legacy)WooCommerceMagentoBigCommerceStandalone

Before you start

The trigger runs on a Shopify customer record, not on an anonymous quiz session. RevenueHunt matches the customer to that record by the email address they type into the quiz. That is why the next two steps matter.

1. Add an email question to your quiz. Without one, no customer record is created, and the trigger never fires. A phone number is not enough. Make the question required to start a workflow run on every completion.
2. Turn on customer syncing. In RevenueHunt, open App settings > Shopify Customers. Turn on Enable pushing quiz leads to Shopify Customers and save. The Shopify Flow section sits on the same page, under that checkbox.
3. Install Shopify Flow if your store does not have it. It is free.
4. Publish the quiz.

For more on customer syncing, including how marketing consent is recorded, see How to Send Quiz leads to Shopify Customers.

Create the workflow

1. Open Shopify Flow.
2. Select Create workflow.
3. Select Select a trigger.
4. Choose Product Recommendation Quiz and then Quiz Completed.
5. Add the conditions and actions you want to run after a quiz completion.
6. Select Turn on workflow.

The trigger carries the Shopify customer along with the full quiz completion. See What data is sent for every available field.

Tip

If you are not sure how to assemble a workflow, describe what you want in plain language. Shopify Sidekick can draft it for you in Flow.

What data is sent

When a customer completes a quiz, RevenueHunt sends a structured payload to Shopify Flow using the quiz-completed trigger. The payload has two top level fields:

• customer_id, the numeric Shopify customer ID
• Quiz completion, an object holding everything about the completion.

Under Add variable in any action, the quiz data is nested under Quiz completion. Which fields you see depends on what the customer submitted and on how the quiz is configured.

Completion fields

Field	Description
eventId	A stable ID for deduplication, in the form quiz-completed:<response-sqid>
schemaVersion	The payload schema version, currently 1.0
responseId, quizId	Internal RevenueHunt identifiers
quizName	The name of the quiz
completedAt	ISO 8601 UTC timestamp of the completion
email	The customer's email address. Always present, since the trigger requires it
phone, firstName, lastName, fullName	Contact details, when the quiz captured them
resultRef, resultName	Identifiers for the quiz result the customer reached
tags	A list of all customer tags associated with the response
marketId	The market identifier
highestVariableRef	The reference of the variable with the highest score
recommendationsIncomplete	true when product data was partially missing at delivery

answers

A list with one object per answered question.

Field	Description
questionRef, questionTitle	Reference and title of the question
blockRef, answerType	Reference of the block and the type of answer it collects
value	The answer itself, stringified
choiceRefs, choiceLabels	The choices picked, for multiple-choice questions
position	Order of the question in the quiz

recommendations

A list of the recommended products or items.

Field	Description
slotRef	The slot identifier
itemId, productId, variantId	Product identifiers
title, url	The product title and link
rank, score	Position in the recommendation list and its matching score
price, currency	The price and its currency

variableScores

A list of the calculated variable scores.

Field	Description
variableRef	The reference of the variable
score	Its calculated score

Limits and eligibility

• The trigger needs an email address in the response, and a Shopify customer record. A completion without an email produces no workflow run.
• The payload is capped at 45 KB, to stay inside Shopify's 50 KB limit. A completion over that size is pruned in order: the recommendation metadata such as URLs and prices, then the oldest answers. recommendationsIncomplete is then set to true. A long quiz with many recommendations is the usual cause. Do not rely on every optional field being present in every run.

Example 1: email your team after every quiz completion

This is the fastest way to prove the chain works. You control both ends, and you see the quiz data arrive in your inbox.

1. Create a workflow with the Quiz Completed trigger.
2. Under the trigger, select the + button and choose Action.
3. Search for Send internal email and select it.

4. In Email address, type the address that should receive the notification, for example your own. To notify several people, separate the addresses with commas.

   Warning

   The recipient must be a fixed address. Shopify does not let you insert a variable here, so this action cannot email the customer. It is built for notifying staff.

5. In Subject, type the static part of your subject line, for example Quiz completed by.

6. Place your cursor where the dynamic part goes, select Add variable, and pick the field you want. To identify the customer and the quiz, insert the customer's first name and the quiz name.
7. In Message, write the body the same way, mixing text with Add variable. The quiz completion data is worth using here. Insert the product recommendations, so the email lists the recommended titles with their price or URL.
8. Select Turn on workflow.
9. Complete your published quiz with a real email address and check your inbox.

The result is an email such as "Skincare Quiz completed by Anna", listing the products the quiz recommended to her.

Tip

Formatting in the message body is up to you. Add line breaks and labels around the variables so the email stays readable once several fields are filled in.

Example 2: branch on a quiz answer

Most workflows should not treat every customer the same. Use a condition to split the workflow on what they answered, then run a different action on each side.

The cleanest thing to branch on is a customer tag, because you decide in the quiz builder exactly which answers produce which tag.

First, tag the choices you want to branch on

1. Open the RevenueHunt app and select your quiz.
2. Click the choice you want to tag to open its settings.
3. Under Customer tags, create a new tag or pick an existing one. For example, tag the dry skin choice with dry skin.
4. Repeat for the other choices you want to identify later.
5. Add a common tag such as quiz to every choice in one of the questions, so that every customer carries it.
6. Click Save.

Every tag attached to the choices a customer picks is written to their Shopify customer profile, and arrives with the trigger.

Then build the condition

1. Under the trigger, select the + button and choose Condition.
2. Select Add variable.
3. Search for tags and select the tags field belonging to the quiz completion. Flow lists variables in dot notation, so read the full path before selecting, since several unrelated tags fields exist.
4. Because tags are a list, set the list operator to At least one of.

5. Leave the field operator as Equal to. Type the tag exactly as you named it in the quiz builder, for example dry skin.

   Note

   Tags are sent to Shopify with no prefix, so the value here is the same string you typed into the quiz builder. Match the spelling and the spacing.

6. Check the plain language summary Flow displays above the condition. It should read as the rule you intended.

7. Attach an action to the True branch, for example an email about your dry skin range.
8. Attach a different action to the False branch, or leave it empty to end the workflow there.
9. Select Turn on workflow.

To test both sides, complete the quiz twice, once choosing the answer that carries the tag and once choosing an answer that does not.

Send a marketing email to the customer

Send internal email cannot email the customer who took the quiz. That needs a marketing email action, which Shopify Flow does not provide. Your email app contributes it, so the name you search for depends on your setup, for example Shopify Messaging, Klaviyo or Seguno.

Warning

A marketing email only reaches a customer who is subscribed to marketing. For anyone who is not subscribed, the action fails on that run. Quiz leads are marked as subscribed by default, as Change subscribed/consent status for email and phone questions describes.

Shopify's own email automations moved

Since 24 March 2026, marketing automations that use Shopify Messaging emails are managed in the Shopify Messaging app, under Apps > Messaging > Automations. Automations whose marketing action comes from another app stay in Shopify Flow. Existing automations kept working through the move, so nothing needs rebuilding.

To add one:

1. Under the trigger or on a condition branch, select the + button and choose Action.
2. Search for the sending action provided by your email app.
3. Select the template or campaign you want to send.
4. Select Turn on workflow.

Other actions worth combining with the trigger

Everything below is built into Shopify Flow, so it is available without installing anything else.

Action	Typical use with quiz data
Add customer tags	Build a segment from a quiz answer, or mark that someone has taken a particular quiz
Remove customer tags	Clear a previous answer when a customer retakes the quiz
Update customer note or a customer metafield	Store the recommended products on the profile so your team, or your theme, can read them later
Send HTTP request or Send Admin API request	Pass the completion to a system that has no Flow app
Wait	Delay a follow-up, for example send a reminder three days after the quiz
Condition	Branch on tags, answers, or quiz variable scores, as in Example 2

Note

Storing the recommendations in a metafield makes them available to your theme. Displaying them on the storefront is theme work, which Flow does not do.

Check the connection in RevenueHunt

Return to RevenueHunt > App settings > Shopify Customers and find the Shopify Flow section.

• Flow active means Shopify has reported that a workflow using the Quiz Completed trigger from Product Recommendation Quiz is turned on.
• Flow inactive means a workflow was detected but is not currently turned on.
• Flow not detected means Shopify has not reported a workflow using this trigger yet.

Note

Shopify may take a short time to report a workflow status change. The lifecycle timestamp shows when RevenueHunt last received an update from Shopify.

Test the workflow

1. Complete the published quiz with an email address.
2. In Shopify Flow, open the workflow and review its recent runs.
3. Confirm that the expected conditions and actions completed successfully.

If no run appears, a setup step is usually the cause. Check in this order: the email question was filled in during the test, customer syncing is on, and the workflow is turned on. Then complete the quiz again.

Note

The Quiz Completed trigger is different from workflows that start with Shopify's Customer created trigger and filter by customer tags. Use Quiz Completed when you want the workflow to run directly from the Product Recommendation Quiz completion event.

Warning

The Quiz Completed trigger is not available in the legacy version of the app. It is provided by the Built for Shopify version of RevenueHunt only.

You can still automate what happens after a quiz, with Shopify's own Customer created trigger and a condition on customer tags. The workflow starts when the quiz creates a new customer, not on the quiz completion. Quiz answers, recommendations and variable scores are not available inside the actions.

Step 1: Connect the quiz to Shopify Customers

Your quiz must contain an email question. Without one, no customer is created and the automation has nothing to run on.

1. Go to your quiz and click on the Connect tab on the top of the screen.
2. Click the Connect button in the Shopify Customers section. This authorizes our app to connect with your Shopify Customers List.
3. Click the Publish button to save the changes and update the preview/live quiz with new settings.

Step 2: Tag your quiz choices

1. Open your quiz and navigate to the Customer Tags section.
2. Create a tag for each choice you want to identify later. For example, create a tag called teen and assign it to the relevant choice.
3. Add a common tag such as quiz to every choice in one of the questions, so that every customer carries it.
4. Click Publish to save your changes.

Note

Tags coming from the quiz will have a prq_ prefix added. So if you created a tag called teen, in the Shopify profile it will be available as prq_teen.

Step 3: Build the automation

1. To set up a post-quiz automation go to Apps > Messaging > Automations in your Shopify admin and click Create automation. Older stores may still reach the same screen from Marketing > Automations > View templates.
2. Select a Create custom automation automation:

3. Add a trigger: Click anywhere and select the first trigger to be Customer created.

   Warning

   This fires only for a brand new customer. Anyone already in your Shopify Customers list is updated rather than created, so the automation does not run for them.

4. Select a condition: Add a Condition action after the trigger. Click Add variable and from the list look for customer and then tags. Then, set up the condition as follows:

   At least one customer / tags includes tags_item prq_quiz.

   

   Note

   You need to add the full name of the tag. For example, prq_oilyskin or prq_Oily Skin.

   

5. Set up an email: Click Then > Action and select Send marketing email. Then pick the email template. This sends a follow-up to every quiz contact carrying the prq_ tag, as soon as the tag is added.

6. Save: Click Turn on workflow once you are done.

Step 4: Test it

Complete your published quiz with an email address that is not yet in your Shopify Customers list. Then open the automation and check its recent runs.

Every customer carrying that prq_ tag is then sent the marketing email.

To learn more about Shopify Automations, check their FAQ page.

Tip

The Built for Shopify version gives you the Quiz Completed trigger. It also drops the prq_ prefix from your tags, and makes the full quiz completion available to your actions. See Migrate a Legacy Quiz to Built for Shopify.

For the same walkthrough in context, see the Shopify (Legacy) tab of Set up Shopify Flow.

Platform Availability

Shopify Flow is a Shopify product, so this does not apply to WooCommerce.

To automate follow-ups, connect your quiz to an email or CRM service instead. See How to Send Quiz Leads to Your CRM.

Platform Availability

Shopify Flow is a Shopify product, so this does not apply to Magento.

To automate follow-ups, connect your quiz to an email or CRM service instead. See How to Send Quiz Leads to Your CRM.

Platform Availability

Shopify Flow is a Shopify product, so this does not apply to BigCommerce.

To automate follow-ups, connect your quiz to an email or CRM service instead. See How to Send Quiz Leads to Your CRM.

Platform Availability

Shopify Flow is a Shopify product, so this does not apply to Standalone.

To automate follow-ups, connect your quiz to an email or CRM service instead. See How to Send Quiz Leads to Your CRM.