Support
We answer every email: hello@fairstride.app, usually within one business day.
Quick start
- 1. Create: open the app and pick the Product finder. Choose 2 to 5 of your collections, usually preselected for you, then select Create my product finder.
- 2. Connect: on each answer, use Add rule to point it at a product, collection, or tag. The editor shows a live preview the whole time.
- 3. Publish: the Publish button checks everything first and tells you if a step is missing.
- 4. Add to your theme: use the Open theme editor button, add the Product Quiz block to any page, and save. The quiz follows your theme's fonts. Set its accent color in the block settings.
- 5. Test it yourself: take the quiz once on your storefront. Your response appears in the app under View responses.
Share a link to your quiz
Every published quiz also has its own page on your store, inside your theme's header and footer. Put the link in an email, an ad, or your Instagram bio. It works without the Product Quiz block.
To copy the link, open the quiz in the app, select Quiz settings, then select Copy link next to Share link. Right after you publish, the Quiz published message also has a Copy share link button.
- The link is your store's address followed by
/apps/quiz/take/and the quiz ID. The browser tab shows the quiz title. - The page uses your theme's fonts, and its accent color follows your theme's button color. If that color is too light for white text, or the page can't find it, the accent stays black. Settings you change on the block in the theme editor, including Accent color, don't apply to the page.
- Responses from the page appear under View responses and count toward your plan's monthly response limit, the same as responses from the block.
- While the quiz is unpublished, the page says "This quiz isn't available right now." Publish it again and the same link works again.
Common answers
- The quiz is not showing on my storefront: check the quiz is Published in the app, and the Product Quiz block is added and saved in your live theme. If both are true and it still does not show, email us your store domain.
- Which quiz shows in the block? The block shows your most recently published quiz by default. To pin a specific quiz, put its ID (shown in the app) in the block's settings in the theme editor.
- Responses stopped counting: you may have reached your plan's monthly response limit. The quiz keeps showing; new responses pause until the 1st of the month. Nothing is deleted.
- Email capture is not blocking results: the "require email" setting only takes effect while the quiz contains an email question.
- Exporting data: View responses, then Export CSV. The file includes answers, emails, and products shown.
Show a welcome screen before question 1
A welcome screen shows a title, a line of text, and a Start button before the first question. You can add an image too. It is off for every quiz until you turn it on.
- Open the quiz in the app and select Welcome screen in the quiz outline.
- Select Show a welcome screen before the first question.
- To use your own wording, fill in Welcome screen title, Welcome screen text, and Start button. Leave the title empty to show the quiz title.
- To add an image, select Add image. On a phone the image shows above the text, and on a wider screen beside it.
- Save the quiz.
Starts on the Responses page, and the fairstride:quiz_started event, still count from the shopper's first answer, not from the Start button. A shopper who leaves on the welcome screen counts as a view only. Retake quiz goes straight back to question 1.
Let shoppers type their own answer
A choice question can end with an Other answer. A shopper who picks Other types their own answer in a text box, up to 200 characters. They can't continue until they type something.
To add it, select the question in the quiz outline and select Add an "Other" answer below its answers. Then save the quiz. Each question has its own setting, and it is off by default.
- On a single-choice question, Other takes the place of the shopper's pick. On a multiple-choice question, shoppers can pick Other along with your answers.
- Other doesn't change which products the quiz recommends. With only Other picked, questions that show after one of this question's answers stay hidden.
- The response, the responses list, and that question's column in the CSV export show the typed answer, for example "Other: sensitive skin".
- The Answers card on the Responses page shows an Other (typed answers) row for the question.
- Notification emails and Shopify Flow say Other but leave out the typed text. Klaviyo receives only the answers the shopper picked.
- To reword Other or the text box placeholder, edit Other answer and Other answer placeholder under Widget text & email.
Send quiz events to Meta or Google Analytics
The quiz sends two events to Shopify's customer events. A custom pixel can pass them on to Meta Pixel, Google Analytics, or another tool.
fairstride:quiz_started: the shopper answers or skips the first question. Retake quiz starts a new attempt, so the event fires again.fairstride:quiz_finished: the app saves the shopper's response and shows the results. It fires once per attempt, for the same responses you see under View responses.
Both events carry the quiz's ID and title as event.customData.quizId and event.customData.quizTitle. They never include the shopper's answers or email. The app's Preview sends no events.
To set it up:
- In Shopify admin, go to Settings, then Customer events, and select Add custom pixel. Give it a name, such as Fairstride quiz.
- Paste the base code from Meta Events Manager or Google Analytics, without its
<script>tags. - If Shopify's Facebook & Instagram app already tracks page views, delete the base code's
fbq('track', 'PageView');line. If Shopify's Google & YouTube app already does, change the config line togtag('config', 'G-XXXXXXXXXX', { send_page_view: false });, with your own ID. Otherwise each page view counts twice. - Paste the matching lines below after the base code, then select Save and Connect. Shopify runs the pixel only for shoppers whose consent allows it under the pixel's Customer privacy settings.
- Take the quiz on your storefront, then look for the events in Meta Events Manager under Test events, or in Google Analytics under Realtime.
For Meta Pixel:
analytics.subscribe("fairstride:quiz_started", (event) => {
fbq("trackCustom", "QuizStarted", {
quiz_id: event.customData.quizId,
quiz_title: event.customData.quizTitle,
});
});
analytics.subscribe("fairstride:quiz_finished", (event) => {
fbq("trackCustom", "QuizCompleted", {
quiz_id: event.customData.quizId,
quiz_title: event.customData.quizTitle,
});
});
For Google Analytics:
analytics.subscribe("fairstride:quiz_started", (event) => {
gtag("event", "quiz_start", {
quiz_id: event.customData.quizId,
quiz_title: event.customData.quizTitle,
});
});
analytics.subscribe("fairstride:quiz_finished", (event) => {
gtag("event", "quiz_complete", {
quiz_id: event.customData.quizId,
quiz_title: event.customData.quizTitle,
});
});
You can rename QuizStarted, QuizCompleted, quiz_start and quiz_complete to match your own reports. To see the quiz ID and title in Google Analytics reports, register quiz_id and quiz_title as custom dimensions.
Start a Shopify Flow workflow when a shopper finishes
The app adds a Quiz completed trigger to Shopify Flow. It runs once for each response you see under View responses, when the shopper gets their results. Use it to post each finished quiz to Slack, add a row to a Google Sheet, or email your team.
The trigger gives your workflow these details:
- The quiz ID, the quiz title, and the response ID.
- The recommended products, best match first, each with its product ID, title, and product page URL.
- The shopper's answers in quiz order, each with the question and the answers they picked. Skipped questions are left out, and an Other answer shows as Other, without the text the shopper typed.
It includes no email address and no customer, so a workflow can't tag the customer or email the shopper. The app's Preview doesn't run it, and neither do responses paused by your plan's monthly limit.
To set it up:
- Open the Shopify Flow app and create a workflow.
- For the trigger, search for Quiz completed. It is listed under Fairstride Product Quiz.
- Add your actions. To put quiz details in a message or a row, use Add a variable in the action's fields.
- Turn on the workflow. Take the quiz on your storefront, then check that the workflow ran.
See where shoppers leave the quiz
The Where shoppers leave card on the Responses page lists your questions in quiz order, including the email step. Each line shows how many of the shoppers who reached that question left the quiz there, for example 9% left (37 of 412). A question that no one reached shows Not reached.
- Counting starts at a shopper's first answer, the same moment the app counts a start. A shopper who opens the quiz and leaves without answering isn't counted on question 1. Those shoppers show only as the gap between Views and Starts.
- A shopper who goes back to an earlier question and leaves from there counts on that question.
- The card follows the date range at the top of the page. It appears once a shopper has reached a question in that range, and days before the card was added to the app have no data.
Data requests
To export or delete your store's data, email hello@fairstride.app from the email on your Shopify account. Deletion completes within 30 days. See the privacy policy for details.
When you write
Include your store domain (yourstore.myshopify.com) and, if it is about a specific quiz, the quiz name. Screenshots help.