> ## Documentation Index
> Fetch the complete documentation index at: https://store-docs.quizify.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Unexpected Errors in the Quiz

> Guide to diagnosing unexpected errors in a Quizify quiz — blank screens, JavaScript console errors, broken layouts — with steps to investigate and report the issue.

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.