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

# Publish

> Put your quiz on your Shopify store as a page embed or popup. App Embed must be ON.

You can show the quiz in two ways:

<table class="qh-table-choice">
  <thead>
    <tr>
      <th>What you want</th>
      <th>Choose this</th>
      <th>What customers see</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>Show the quiz on a page<br />(home, product, collection, custom page, and more)</td>
      <td>Embed quiz</td>
      <td>The quiz appears as part of the page content</td>
    </tr>

    <tr>
      <td>Show the quiz in a popup window</td>
      <td>Popup quiz</td>
      <td>The quiz opens over the store page</td>
    </tr>
  </tbody>
</table>

Open Publish from:

Shopify Admin → Apps → Quizify → My Quizzes → Edit → Publish

You can also click Embed Quiz at the top of the Quiz Builder.

## Save Your Quiz

Finish building your quiz, then click Save.

## Set Status to Published

Change the quiz status from Draft to Published.

If you see Publish the quiz first to enable this action, the quiz is still a Draft. Switch it to Published and try again.

## Turn App Embed ON (Required)

App Embed must be ON for any quiz to work on your storefront. Without App Embed, customers will not see or take the quiz — even if the quiz is published and placed correctly.

### How to turn App Embed ON

1. Go to Shopify Admin → Online Store → Themes.
2. Click Customize on your current theme.
3. Open App embeds.
4. Find Quizify.
5. Turn the Quizify toggle ON.
6. Click Save.

You can also enable App Embed from the Quizify Home Get Started guide (Enable App Embed task).

Remember: App Embed ON + quiz status Published are both required before customers can use your quiz.

## Choose Your Method

### Embed Quiz — Show the Quiz on a Page

Use Embed quiz when you want the quiz to appear as part of a page.

<table>
  <thead>
    <tr>
      <th>Method</th>
      <th>Best for</th>
      <th>What you do</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>Theme app block</td>
      <td>Most Shopify themes (easiest option)</td>
      <td>Add a Quizify block in the theme editor, then paste your Quiz ID</td>
    </tr>

    <tr>
      <td>Page or custom section</td>
      <td>Custom pages, HTML blocks, or Liquid sections</td>
      <td>Copy the embed code and paste it into your theme or page content</td>
    </tr>
  </tbody>
</table>

### Popup Quiz — Show the Quiz in a Popup

Use Popup quiz when you want the quiz to appear over the store.

<table>
  <thead>
    <tr>
      <th>Method</th>
      <th>Best for</th>
      <th>What you do</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>Automatically</td>
      <td>Welcome popups, offers, or quizzes that open on their own</td>
      <td>Add a Popup Quiz block in the theme editor and set when it appears</td>
    </tr>

    <tr>
      <td>On click</td>
      <td>Buttons, menus, banners, or “Take the quiz” links</td>
      <td>Copy a popup link and add it to a clickable item on your store</td>
    </tr>
  </tbody>
</table>

Note: Popup quiz may depend on your Quizify plan.

## Embed Quiz: Put the Quiz on a Page

Open Publish → Embed quiz.

Before you continue, confirm:

* Quiz status is Published
* App Embed is ON

### Theme App Block (Recommended)

Use this when you want to add the quiz without editing code.

1. Open Embed quiz → Theme app block.
2. Choose your Theme (usually your live theme).
3. Choose where the quiz should appear:

<table>
  <thead>
    <tr>
      <th>Page template</th>
      <th>Where the quiz shows</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>Home page</td>
      <td>Your store homepage</td>
    </tr>

    <tr>
      <td>Product page</td>
      <td>Individual product pages</td>
    </tr>

    <tr>
      <td>Collection page</td>
      <td>Collection listing pages</td>
    </tr>

    <tr>
      <td>Standard page</td>
      <td>Custom pages (About, FAQ, and similar)</td>
    </tr>

    <tr>
      <td>Blog post</td>
      <td>Blog article pages</td>
    </tr>

    <tr>
      <td>Cart</td>
      <td>Cart page</td>
    </tr>

    <tr>
      <td>Search</td>
      <td>Search results page</td>
    </tr>
  </tbody>
</table>

4. Click Copy next to Quiz ID.
5. Click Add Embed Quiz Block. This opens the Shopify theme editor.
6. In the Quizify block settings, paste the Quiz ID.
7. Click Save in the theme editor.
8. Open that page on your live store to confirm the quiz shows.

### Paste Embed Code / Page or Custom Section

Use this when Theme app blocks are not available, or you want the quiz inside custom page content.

1. Open Embed quiz → Page or custom section.
2. Click Copy next to the Embed code.
3. In Shopify, open the page or section where you want the quiz.
4. Paste the code into one of these places:

<table>
  <thead>
    <tr>
      <th>Where to paste</th>
      <th>When to use it</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>HTML block</td>
      <td>Simple content sections that accept HTML</td>
    </tr>

    <tr>
      <td>Custom Liquid section</td>
      <td>More flexible theme sections</td>
    </tr>

    <tr>
      <td>Any section that accepts HTML</td>
      <td>Custom layouts or special page content</td>
    </tr>
  </tbody>
</table>

5. Save the page or theme.
6. Check the live page to confirm the quiz shows.

## Popup Quiz: Show the Quiz in a Popup

Open Publish → Popup quiz.

Before you continue, confirm:

* Quiz status is Published
* App Embed is ON

### Choose how you want to pop up the quiz

### Opens Automatically

The quiz popup can appear on its own on the pages you choose.

1. Open Popup quiz → Automatically.
2. Choose your Theme.
3. Choose the page type (Home, Product, Collection, Standard page, Blog post, Cart, or Search).
4. Click Copy next to Quiz ID.
5. Click Add Popup Quiz Block. This opens the Shopify theme editor.
6. Paste the Quiz ID into the popup block settings.
7. Set when the popup should appear (for example delay, how often, and display rules).
8. Click Save in the theme editor.
9. Visit the live page to test the popup.

### Opens When Someone Clicks a Link

The quiz opens only when a customer clicks a button, menu item, banner, or other link.

1. Open Popup quiz → On click.
2. Choose a popup size. Changing the size updates this link automatically.

<table>
  <thead>
    <tr>
      <th>Size</th>
      <th>What it looks like</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>Fullsize</td>
      <td>Large popup that fills most of the screen</td>
    </tr>

    <tr>
      <td>Medium</td>
      <td>Standard centered popup</td>
    </tr>

    <tr>
      <td>Small</td>
      <td>Compact popup</td>
    </tr>
  </tbody>
</table>

3. Click Copy next to the Popup link.
4. In Shopify, add that link to a button, menu item, banner, or any custom link.
5. Save your theme or menu.
6. Click the link on your live store to confirm the popup opens.

## Quick Checklist

After you publish, confirm all of these:

<table>
  <thead>
    <tr>
      <th>Check</th>
      <th>Why it matters</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>Quiz status is Published</td>
      <td>Draft quizzes cannot go live on the store</td>
    </tr>

    <tr>
      <td>App Embed is ON</td>
      <td>Without App Embed, the quiz will not work on the storefront</td>
    </tr>

    <tr>
      <td>Correct Quiz ID, embed code, or popup link is used</td>
      <td>Wrong ID or link shows the wrong quiz — or nothing</td>
    </tr>

    <tr>
      <td>Theme or page is Saved</td>
      <td>Unsaved theme changes do not appear on the live store</td>
    </tr>

    <tr>
      <td>You tested on the live store</td>
      <td>Preview alone is not enough — always check the real storefront</td>
    </tr>
  </tbody>
</table>

## Notes

* App Embed must be ON, or quizzes will not work on your storefront — even if they are published.
* Draft quizzes cannot be placed on the store until you set them to Published.
* Always use the Quiz ID from the same quiz you want to show.
* Theme app block is usually the simplest embed method.
* On-click popup is best for “Take the quiz” buttons.
* Automatic popup is best when you want the quiz to appear without a click.
* After any theme change, test on your live storefront.