> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.komo.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Quiz

> Put your audience's knowledge to the test.

## What is it?

The Quiz allows you to engage your audience whilst putting their knowledge to the test by asking quiz, poll and market research style questions.

## How do I build one?

### Step 1: Add a Quiz to your Hub

<img src="https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/quiz-step-1-add-a-step-1.gif?s=1cdb4609daa607e3e26512236e4ccf14" alt="Quiz: step 1 — Step 1: Add a Quiz to your Hub" width="2000" height="1090" data-path="images/quiz-step-1-add-a-step-1.gif" />

* Navigate to your **Engagement Hub**.
* Once there click the **Plus icon**, from here select **Games** and then **Quiz.**
* You will then see your new card has been added to your Hub.

### Step 2: Adding a Cover image *(Optional)*

<img src="https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/quiz-step-2-adding-a-step-2.webp?fit=max&auto=format&n=2hH4unVX-mPKIOda&q=85&s=df7648a3b0ed24c26df40342a0709011" alt="Quiz: step 2 — Step 2: Adding a Cover image (Optional)" width="3230" height="1830" data-path="images/quiz-step-2-adding-a-step-2.webp" />

* Clicking on the **Quiz** will open the editing module.
* **(1)** You have the option to give your **Quiz** a title.
* **(2)** Here you add your **Cover** image or **(6)** you can turn off the cover here.
* **(3)** Alter the color and copy on the **call-to-action** bar or **(7)** disable the bar here.
* **(4)** You can add an **author** tag by displaying the brand or person who's responsible for the card content.
* **(5)** Add an optional **description** to the card.

### Step 3: Adding Questions

<img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/quiz-step-3-adding-questions-step-3.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=68e25d6a1c01a1f009c2cccd78beb2b6" alt="Quiz: step 3 — Step 3: Adding Questions" width="3232" height="1830" data-path="images/quiz-step-3-adding-questions-step-3.webp" />

When adding content to your Quiz, you have 4 options;

* **(1) Quiz questions** - This allows you to create your own quiz questions and populate them within your Quiz.

  <Accordion title="Understanding Quiz Question">
    <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/quiz-step-3-adding-questions-step-3.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=68e25d6a1c01a1f009c2cccd78beb2b6" alt="Quiz: step 3 — Step 3: Adding Questions" width="3232" height="1830" data-path="images/quiz-step-3-adding-questions-step-3.webp" />

    * **(A)** By clicking the placeholder cover image, you can upload a **video** from your device or using a video URL, or **(I)** you can turn off the question image here.
    * **(B)** Here you will be able to **input** your question.
    * **(C)** Here you will input your question **answers** and imagery (by clicking the placeholder image icon associated with that answer).
    * **(D)** Allows you to add additional **questions.**
    * **(E)** Nominate the correct answer by clicking the **tick** located at the end of that answer.
    * **(F)** Give the question an **Internal name** for analytics purposes.
    * **(G)** You have the option to make this question a **Quiz** or a **Poll.**
    * **(H)** Connect question responses to a **contact property.**
    * **(J)** Here you can optionally add an **Explainer** which will pop up after the user answers this particular question.

        <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/quiz-step-3-adding-questions-screenshot.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=57a93e872f92b5a7956f2095876cbac0" alt="Quiz: step 3: Adding Questions" width="3234" height="1832" data-path="images/quiz-step-3-adding-questions-screenshot.webp" />

      * **(a)** Add your **description/explainer** text here.
      * **(b)** Here you can alter the color of the **Next** button.
    * **(K)** Here you can toggle off the **Question** heading. Use this feature if you add a question into your question image.
    * **(L)** Toggling this option on will randomly **shuffle** each of the different answer options for every user.
    * **(M)** Here you disable displaying the **correct answers** to users.
    * **(N)** Scrolling down, you can show the **response percentage** per answer option.
    * **(O)** If you don't have any result screens, you can enable a **play again** for the last question of the quiz to allow users to play again.
    * **(P)** You can alter the **layout** of the answers by selecting from the options here.
    * **(Q)** Allows you to configure **logic**. The logic jump allows you to take users to different questions within your Quiz based on responses to certain questions. [**Click here to learn more.**](/interactive-features/features/branching-logic/index)
    * **(R)** Brand the experience by altering the quiz **styling colors.**

    <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/quiz-step-3-adding-questions-screenshot-2.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=b08945a2d1cc2fc5728af9af4f2ef97d" alt="Quiz: step 3: Adding Questions" width="3234" height="1832" data-path="images/quiz-step-3-adding-questions-screenshot-2.webp" />

    <Note>
      This setting will apply to all questions.
    </Note>

    * **(a)** Edit the **header** colors.

    <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/quiz-step-3-adding-questions-screenshot-3.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=2b351c99acd2b1fbd09068562b744ced" alt="Quiz: step 3: Adding Questions" width="3234" height="1828" data-path="images/quiz-step-3-adding-questions-screenshot-3.webp" />

    * **(b)** Alter the colours of the question **progress bar**.

    <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/quiz-step-3-adding-questions-screenshot-4.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=d46e146c4cd58d33787cfd97bafe608f" alt="Quiz: step 3: Adding Questions" width="3232" height="1832" data-path="images/quiz-step-3-adding-questions-screenshot-4.webp" />

    * **(c)** Edit the **background color** for the question.

    <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/quiz-step-3-adding-questions-screenshot-5.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=c7d4a45d931c0b7d300d3fa4da2058e8" alt="Quiz: step 3: Adding Questions" width="3224" height="1824" data-path="images/quiz-step-3-adding-questions-screenshot-5.webp" />

    * **(d)** Set the answer option colors and the feedback color.

    <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/quiz-step-3-adding-questions-screenshot-6.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=752ddaa44d3fdeeec1eaece7ef1d699a" alt="Quiz: step 3: Adding Questions" width="3230" height="1834" data-path="images/quiz-step-3-adding-questions-screenshot-6.webp" />
  </Accordion>
* **(2) Poll questions** - Typically utilized for Market Research questions but a great opportunity to create great user-generated content by utilizing divisive topics such as 'Does Pineapple belong on pizza?" (*Hint: It definitely does*)

  <Note>
    <img src="https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/quiz-step-3-adding-questions-option-a.webp?fit=max&auto=format&n=2hH4unVX-mPKIOda&q=85&s=0d2f7bd01648cb27a7b11cf4f071ce4f" alt="Quiz: option a — Step 3: Adding Questions" width="3228" height="1832" data-path="images/quiz-step-3-adding-questions-option-a.webp" />

    The **Poll question** layout is identical to the Quiz layout with the only exception being no correct answer can be selected.
  </Note>
* **(3) Questions from library** - Selecting this will open the Komo content library and give you access to over 40,000 pre-made questions.

  <Note>
    <img src="https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/quiz-step-3-adding-questions-option-a.webp?fit=max&auto=format&n=2hH4unVX-mPKIOda&q=85&s=0d2f7bd01648cb27a7b11cf4f071ce4f" alt="Quiz: option a — Step 3: Adding Questions" width="3228" height="1832" data-path="images/quiz-step-3-adding-questions-option-a.webp" />

    * **(A)** Click on **+ Select** to select the questions you want to add to your Quiz.
    * **(B)** Here you can view the **answer options.**
    * **(C)** Once you have selected your questions, **review your selection and add these questions to your Quiz.**
  </Note>
* **(4) Bridge screen** - Gives you the ability to add a bridging screen between questions. This is a great opportunity to place adverts and promotional images within your Quiz.

  <Accordion title="Managing Bridge Screen">
    <img src="https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/quiz-step-3-adding-questions-option-a.webp?fit=max&auto=format&n=2hH4unVX-mPKIOda&q=85&s=0d2f7bd01648cb27a7b11cf4f071ce4f" alt="Quiz: option a — Step 3: Adding Questions" width="3228" height="1832" data-path="images/quiz-step-3-adding-questions-option-a.webp" />

    * **(A)** Here you can customize the color of the **Next** button.
    * **(B)** Here you have the option to have an **image** to the Bridge screen or upload a **video** from your device or using a video URL.
    * **(C)** Here you **upload or remove** an image. (*We highly recommend having an image uploaded.*)
    * **(D)** Add a **description** which sits on top of the image.
        <Note>
          We recommend toggling this off and adding any text you wish to be included here directly into your design).
        </Note>
    * **(E)** Alter the **text color** which will sit above the imagery.
    * **(F)** Alter the color of the **background**. **Note:** This color will only be seen if there is no image in step **(C).**
    * **(G)** You can **delete** the screen here.
  </Accordion>

### Step 4: Set up your Results

<img src="https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/quiz-step-3-adding-questions-option-a.webp?fit=max&auto=format&n=2hH4unVX-mPKIOda&q=85&s=0d2f7bd01648cb27a7b11cf4f071ce4f" alt="Quiz: option a — Step 3: Adding Questions" width="3228" height="1832" data-path="images/quiz-step-3-adding-questions-option-a.webp" />

* **Results** refer to what will be shown to your users at the end of your Quiz. You can create multiple results which will all correspond to a different number of correct outcomes within your Quiz.
* **(1)** Here you can give your outcome a **title**.
* **(2)** Clicking here will allow you to upload a specific **image** for this result or **(8)** toggle off the result image here.
* **(3)** Scrolling down, the **description** allows you to add context to your result by entering text.
* **(4)** Alter the color and copy of the **share button.**
* **(5)** Change the **outline color and text** of the view answers button or **(10)** disable this button here.
* **(6)** Scroll down, click on the **plus icon** to add a button and to drive traffic to a particular website or to a specific card.

  <Accordion title="Adding Additional Buttons">
    <img src="https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/quiz-step-3-adding-questions-option-a.webp?fit=max&auto=format&n=2hH4unVX-mPKIOda&q=85&s=0d2f7bd01648cb27a7b11cf4f071ce4f" alt="Quiz: option a — Step 3: Adding Questions" width="3228" height="1832" data-path="images/quiz-step-3-adding-questions-option-a.webp" />

    * **(A)** Insert your **URL.**
    * **(b)** Add the **call-to-action** for the button.
    * **(C)** Customise the **button color.**
  </Accordion>
* **(7)** Here you can decide whether or not this result should allow users to enter a competition.
  <Note>
    In order to have a result lead to a Data capture you will need to have first set this up.
  </Note>
* **(9)** Enable the **play again** button for this specific result screen.
* **(11)** Initially, you will be prompted to set the **result range** of this particular outcome. This refers to the total number of correct answers a user must get in order to see this result.
* **(12)** Alter the **result styling colors.**

  <Accordion title="Styling Results">
    <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/quiz-step-4-set-up-option-a.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=5de17b8f5702d1e3f688ee3483a42fde" alt="Quiz: option a — Step 4: Set up your Results" width="3286" height="1888" data-path="images/quiz-step-4-set-up-option-a.webp" />

    <Note>
      This setting will apply to all results.
    </Note>

    * **(A)** Edit the **header bar color**.

        <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/quiz-step-4-set-up-option-a-2.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=ef5fe3a95f35834344f6fcf95cb3eecd" alt="Quiz: option a — Step 4: Set up your Results" width="3228" height="1824" data-path="images/quiz-step-4-set-up-option-a-2.webp" />

    * **(B)** Here you can update the **result background colors**.

        <img src="https://mintcdn.com/komotechnologies/haZ8nFo61lut3UyH/images/quiz-step-4-set-up-option-b.webp?fit=max&auto=format&n=haZ8nFo61lut3UyH&q=85&s=ee1cbfcb149bac79fff7c8edec24ccd1" alt="Quiz: option b — Step 4: Set up your Results" width="3230" height="1832" data-path="images/quiz-step-4-set-up-option-b.webp" />
  </Accordion>
* **(13)** Here you can add **additional result** screens.

### Step 5: Set up your Data capture *(Optional)*

Whilst adding a competition to your Quiz is recommended to collect data, it is not always required and can be used purely as an engagement piece.

<Card title="Ready to set up your competition?" color="#F1E52C" icon="trophy-star" href="/getting-started/hub-setup/data-capture/index" cta="Click here" />

### Step 6: Publish your Card

<img src="https://mintcdn.com/komotechnologies/2hH4unVX-mPKIOda/images/quiz-step-3-adding-questions-option-a.webp?fit=max&auto=format&n=2hH4unVX-mPKIOda&q=85&s=0d2f7bd01648cb27a7b11cf4f071ce4f" alt="Quiz: option a — Step 3: Adding Questions" width="3228" height="1832" data-path="images/quiz-step-3-adding-questions-option-a.webp" />

**Once you've completed all of these steps, played around with your card and are happy with all the aspects of your card, it's time to get your card live!**

* **(1)** **Publish** your card manually and instantly for the world to see.
* **(2)** **Schedule** your card to be published and unpublished at set dates and times.
* **(3)** Click on **...** to **Preview** and interact with the card on the front end from a user's perspective before publishing it. See how to test your card [here](/getting-started/hub-setup/card-testing).

<Note>
  All competition entries will be recorded and will impact the card analytics.
</Note>

## "Go live" checklist

Ready to go live with your Quiz? We recommend reviewing the following list before launching and double-checking if you have:

* All images uploaded are the **correct dimensions**. Export image files in 2x to ensure none of the images appear pixelated.
* Added all your **quiz questions** (including imagery where possible).
* Used **survey** and [**market research**](https://blog.komo.tech/how-businesses-are-using-komo-for-market-research) questions to gain insights and user-generated social media content.
* Created [**personalized communications**](/interactive-features/features/personalised-prizing) for your market research questions.
* Hyperlinked your [**T\&Cs**](/getting-started/resources/terms-conditions) to the opt-in-field, which is created in the **data capture** section of the settings tab.
* Selected the [**correct answer**](#see-it-in-action) for all the questions.
* All your [**result screens**](#step-1-add-a-quiz-to-your-hub) are set up with imagery, copy and the result range.
* If you are using videos in the questions, ensure you have uploaded or copied and pasted the correct **video/URL**. You can play the video in the preview section to check if it is the correct video.
* All your **communications** (Registration, Winner/s, Everybody Else) are fully set up and ready to send.
* If you have a competition attached, ensure your **Prizes** and the awarding rules are set up correctly. If you have **Live prize awarding** as your award, make sure you **enable** this feature, you can see how to do so [here.](/interactive-features/games/live-predictor-card-advanced)
* If you are using **coupons**, make sure the coupons created are set up correctly. Check the coupon limits are set, the copy for each screen is right and you have linked the appropriate coupons to your communications.

Then you're ready to go live!

<Columns cols={2}>
  <Column>
    <Card title="Terms & Conditions Template" color="#F1E52C" icon="file-lines" href="https://docs.google.com/document/d/1SC6VMBeEiCxXSYvrj1SpuS4cIj3zRaae/copy" cta="Download Template" />
  </Column>

  <Column>
    <Card title="Card Design Guidelines" color="#F1E52C" icon="cards-blank" href="https://docs.google.com/presentation/d/1jLglFC9t4qRILOk7RjcZ8QDVt1yASwLMVHlr70LfL4g/edit?usp=sharing" cta="Learn More" />
  </Column>
</Columns>

## Promotion

<Card title="Stuck on how to promote your activation?" color="#F1E52C" icon="megaphone" href="/getting-started/promotion/promoting-your-engagement-hub/index" cta="Click here!" />

## FAQ

**What's the difference between a Quiz Card and a Live Trivia game?**

The Quiz Card allows you to challenge your audience at any time, it is always open, and users can take as long as they like to answer questions. The Live Trivia is best described as a 'pub quiz' available to anyone, anywhere. The Live Trivia is open for a set amount of time (this can be as little or as long as you like), and then once started, users have a set amount of time to answer and be crowned the smartest *Insert topic/team* Fan. Check out the complete [Live Trivia FAQ here.](/interactive-features/quizzes/live-trivia)

**Can The Quiz Card be linked to The Leaderboard Card?**

The Leaderboard card has been built to allow Live Trivia users to immediately see where they sit compared to the rest of the players in the Live Trivia based on the points accumulated and is currently not linkable to a Quiz Card.

**My Quiz is now closed; how do I access the data?**

Press the **Settings Cog** located on the bottom of your Quiz Card; you can then click on **Entries** and download the complete export of data collected or click on the **Analytics** tab to get a high-level overview of the card's performance.

**Why would I utilize a 'Bridge screen'?**

Bridge screens allow you to place promotional or educational content within your Quiz and take advantage of the engagement your Quiz is receiving.

**When are 'Explainers' shown?**

Explainers are shown after a user answers the question.

**Do I have to add Explainers to my Quiz?**

No. Explainer usage is entirely optional but can be a great way to educate your users.

## Top tips

* We recommend leaving the card cover on as it provides additional information about the card/game and it also keeps the Hub looking neat!
* It is best to have between 3-6 questions for maximum engagement.
* Use images for your question cover and/or for the answers. Images are appealing and make it more fun compared to playing a game that's just plain text...
* Add a Bridge screen to promote a product or service. We recommend using an image with text on it than using the text box located on the Bridge screen. This is so you can place the text any way you want with your own font.
* Set up coupons for users who get all answers correct.
* To do this, first set up a **result screen**, set the **result range** to the maximum potential correct and turn on the **this result leads to form** option.
* Next set up a second result screen, set the result range from 0 to 1 less than the maximum correct answers and turn off the **this result leads to form** option.
* Finally set up a communication with a coupon attached and set the trigger to on-form registration.
* Create a fun and engaging quiz! Don't ask simple questions, get users to really think!
* Make poll questions interesting! Spark debates, gather insights on things you are curious about e.g. Does pineapple belong on pizza?, What do you put on top of your Christmas tree? etc.
