Unexpected Errors in the Quiz

If your quiz is showing a blank screen, a broken layout, or behaving unexpectedly in the middle of a quiz flow, this guide helps you diagnose the issue and collect the information needed to resolve or report it.

Types of Unexpected Errors

Blank screen: The quiz container is present but shows no content — a completely empty area where the quiz should be.

Quiz stuck mid-flow: The quiz stops responding after a certain question — clicking answers or the Next button does nothing.

Broken layout: The quiz renders but elements are misaligned, overlapping, cut off, or displayed in the wrong order.

JavaScript error in browser console: A red error message appears in the browser developer console at the point where something goes wrong.

Error message displayed in the quiz: A visible error message or "something went wrong" notice appears within the quiz interface.

Step 1: Check the Browser Console for Error Messages

The browser console is your primary diagnostic tool.

Open the quiz page on your storefront
Press F12 (or right-click → Inspect) to open developer tools
Click the Console tab
Reload the page and reproduce the error
Look for red error messages — note the full error text and the file name/line number shown

Common error types:

Uncaught TypeError — a script is trying to use a value that does not exist
CORS error — a script is being blocked by browser security policies
404 Not Found (in the Network tab) — a required file is missing

Step 2: Identify the Error Trigger

Try to reproduce the error consistently:

Go through the quiz step by step
Note exactly which step causes the error — which question, which answer, or which transition
Check whether the error happens every time or only sometimes
Try the same steps in a different browser

Step 3: Check for Conflicting Theme Scripts

Theme customisations and third-party app scripts can sometimes conflict with Quizify:

Test the quiz using the default Shopify Dawn theme (create a duplicate if needed)
If the quiz works on Dawn but not your custom theme, the conflict is theme-related
Also try temporarily disabling recently installed apps to isolate a conflicting script

Step 4: Test in a Different Browser and on Different Devices

Some errors are browser-specific or device-specific:

Test on Chrome, Firefox, Safari, and Edge
Test on a mobile device (both iOS and Android)
Note which browsers or devices reproduce the error and which do not

Step 5: Collect Information Before Reporting

If you cannot resolve the issue yourself, collect the following before contacting Quizify support:

The exact error message from the browser console
The URL of the page where the quiz is embedded
The quiz name and ID from Quizify
Which browser(s) and OS reproduce the issue
Steps to reproduce the error consistently
A screenshot or screen recording of the error

The more detail you provide, the faster the issue can be investigated.

Frequently asked questions

How do I report a bug in Quizify?

Contact Quizify support through the help channel in your Shopify admin or the Quizify dashboard. Include the following information: the browser console error message, the page URL, the quiz name, the steps to reproduce the issue, which browsers are affected, and a screenshot or screen recording if possible.

The quiz layout is broken on a specific page but works on others.

This suggests a CSS conflict on that specific page. Open the browser developer tools and use the Inspect element panel to check for CSS rules that may be affecting the quiz container. A custom CSS rule on that page template may be overriding Quizify's styles.

The quiz shows a blank screen after the first question.

Open the browser console (F12) and look for a JavaScript error that appears after you answer the first question. This is typically a script conflict or a data error triggered by your quiz's conditional logic or recommendation settings. Note the error message and check whether the issue occurs on a specific answer selection. Contact support and provide those details.

The quiz worked fine and then suddenly broke — what do I do?

Think about what changed recently: a new app was installed, the theme was updated, a Shopify platform update occurred, or a change was made to the quiz itself. Test each recent change in reverse to isolate the cause. If nothing obvious has changed, check the Shopify admin for any automatic updates to installed apps.