Skip to main content
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.
  1. Open the quiz page on your storefront
  2. Press F12 (or right-click → Inspect) to open developer tools
  3. Click the Console tab
  4. Reload the page and reproduce the error
  5. 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:
  1. Go through the quiz step by step
  2. Note exactly which step causes the error — which question, which answer, or which transition
  3. Check whether the error happens every time or only sometimes
  4. 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:
  1. Test the quiz using the default Shopify Dawn theme (create a duplicate if needed)
  2. If the quiz works on Dawn but not your custom theme, the conflict is theme-related
  3. 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:
  1. Test on Chrome, Firefox, Safari, and Edge
  2. Test on a mobile device (both iOS and Android)
  3. 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.