> ## 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.

# Memory Challenge

> Match the pairs before time runs out

## What is it?

The Memory Challenge is a fun, interactive memory game where users will need to match the exact pairs or associations before time runs out. Score points for every match, lose points for mismatches, and gain bonus points for streaks!

## How do I build one?

### Step 1: Add a Memory Challenge to your Hub

<img src="https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/memory-challenge-step-1-add-a-step-1.gif?s=a54539886184d06230e24f7c9566b2eb" alt="Memory Challenge: step 1 — Step 1: Add a Memory Challenge to your Hub" width="2000" height="1088" data-path="images/memory-challenge-step-1-add-a-step-1.gif" />

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

### Step 2: Add a Cover image

<img src="https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/memory-challenge-step-2-add-a-step-2.webp?fit=max&auto=format&n=gslKLBOHswpMZg4u&q=85&s=bd4904520f0b9111ed3f12971a040e3f" alt="Memory Challenge: step 2 — Step 2: Add a Cover image" width="2940" height="1840" data-path="images/memory-challenge-step-2-add-a-step-2.webp" />

* Clicking on the **Memory Challenge** will open the editing module
* **(1)** By clicking here you can add a **title** to your Memory Challenge card
* **(2)** This is where you can upload a **cover image**
* **(3)** Here you can edit the color and copy of the **call-to-action bar** or **(8)** toggle this off here
* **(4)** Set the **Outer card shell colors** (description and share bar)
* **(5)** You can add an **Author** tag by displaying the brand or person who's responsible for the card content
* **(6)** Add a **Description** to the card
* **(7)** Here you can **disable** the title

### Step 3: Edit the Instructions screen

<img src="https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/memory-challenge-step-3-edit-the-step-3.webp?fit=max&auto=format&n=gslKLBOHswpMZg4u&q=85&s=d75ae1f8849714fddfedd0a86cba9787" alt="Memory Challenge: step 3 — Step 3: Edit the Instructions screen" width="2940" height="1840" data-path="images/memory-challenge-step-3-edit-the-step-3.webp" />

* **(1)** Edit the **header bar** here by altering the color and uploading your logo
* **(2)** Scrolling down, add a **title** to the instructions and **(5)** change the **font color** here
* **(3)** Include a **description** and **(6)** change the **font color** here
  <Note>
    We recommend putting the rules of the game here. E.g. Match all the pairs in under 60 seconds to win!
  </Note>
* **(4)** Alter the **call-to-action bar** here

### Step 4: Edit the Gameplay screen

<img src="https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/memory-challenge-step-4-edit-the-step-4.webp?fit=max&auto=format&n=gslKLBOHswpMZg4u&q=85&s=58117c56e7ca2fee02192a32db8cdefb" alt="Memory Challenge: step 4 — Step 4: Edit the Gameplay screen" width="2940" height="1840" data-path="images/memory-challenge-step-4-edit-the-step-4.webp" />

* **(1)** Add a **description** to the game
* **(2)** Click here to edit the **timer**
* **(3)** Here is where you'll edit the **scoring table**

  <Accordion title="Editing the Scoring Table">
    <img src="https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/memory-challenge-step-4-edit-the-option-a.webp?fit=max&auto=format&n=gslKLBOHswpMZg4u&q=85&s=f1143f9ffb6574ade1290632f6a47c81" alt="Memory Challenge: option a — Step 4: Edit the Gameplay screen" width="2940" height="1840" data-path="images/memory-challenge-step-4-edit-the-option-a.webp" />

    * **(A)** Alter the **background color** of the table and **text color** here
    * **(B)** Edit the **timer bar** color or **toggle off** this feature here
  </Accordion>
* **(4)** Here is where you'll upload all your **game assets**

  <Accordion title="Uploading Gaming Assets">
    <img src="https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/memory-challenge-step-4-edit-the-option-a-2.webp?fit=max&auto=format&n=gslKLBOHswpMZg4u&q=85&s=6dd320763442897b03432b72e8cbaeca" alt="Memory Challenge: option a — Step 4: Edit the Gameplay screen" width="2940" height="1840" data-path="images/memory-challenge-step-4-edit-the-option-a-2.webp" />

    * **(A)** Upload an image for the **back** of the tiles (we recommend using your logo in the designs here)
    * **(B)** Here you can select whether you want the pairs to be **exact matches** (ie. two pizza slices) or **associated images** (ie. pizza slice and Italian Flag) <img src="https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/memory-challenge-step-4-edit-the-option-a-3.webp?fit=max&auto=format&n=gslKLBOHswpMZg4u&q=85&s=a2d8de3240635ca01ff004c4f22b20f5" alt="Memory Challenge: option a — Step 4: Edit the Gameplay screen" width="2940" height="1840" data-path="images/memory-challenge-step-4-edit-the-option-a-3.webp" />
      * **(a)** If the Association pairing mode is chosen, you can **upload two different images for each pair here**
    * **(C)** If the Matching pairing mode is chosen, you can **upload your single image for each paired here**
    * **(D)** You can add more pairs to the game using the **plus icon**
  </Accordion>
* **(5)** Click here to edit the **gameplay styling**

  <Accordion title="Editing the Gameplay Styling">
    <img src="https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/memory-challenge-step-4-edit-the-option-c.webp?fit=max&auto=format&n=gslKLBOHswpMZg4u&q=85&s=f083af4e4ef5cc5cd401f6f18696b09c" alt="Memory Challenge: option c — Step 4: Edit the Gameplay screen" width="2940" height="1840" data-path="images/memory-challenge-step-4-edit-the-option-c.webp" />

    * **(A)** Edit the **header bar** here
        <Note>
          The settings made in Step 3(1) will be the same for all screens.
        </Note>
    * **(B)** Change the **description text color** here
    * **(C)** Upload an image for the **background** or select a **solid color**
  </Accordion>

### Step 5: Edit your Result screens

<img src="https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/memory-challenge-step-5-edit-your-option-c.webp?fit=max&auto=format&n=gslKLBOHswpMZg4u&q=85&s=bd4cb411e50dca26a2bb47f7c062306d" alt="Memory Challenge: option c — Step 5: Edit your Result screens" width="2940" height="1840" data-path="images/memory-challenge-step-5-edit-your-option-c.webp" />

* **(1)** Add a **title** to the winning screen
* **(2)** Add a **description** to the result screen
* **(3)** You can alter the color and copy of the **share** call-to-action bar
* **(4)** Alter the color and copy of the **play again** call-to-action bar or **(6)** disable the button here
* **(5)** Edit the **result card** background and text color here
* **(7)** Click here to edit the **failure screen**

  <Accordion title="Editing the Failure Screen">
    <img src="https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/memory-challenge-step-5-edit-your-step-5.webp?fit=max&auto=format&n=gslKLBOHswpMZg4u&q=85&s=cd5762c65262180c29afada4fab99ebb" alt="Memory Challenge: step 5 — Step 5: Edit your Result screens" width="2940" height="1840" data-path="images/memory-challenge-step-5-edit-your-step-5.webp" />

    <Note>
      The settings made in Step 5(5) will also apply to this screen.
    </Note>

    * **(A)** Add a **title** to the failure screen
    * **(B)** Add a **description** to the screen
    * **(C)** Alter the color and copy of the **play again** call-to-action or **(D)** you can **disable** this button here
  </Accordion>

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

Whilst adding a competition to your Memory Challenge 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 7: Attach a Leaderboard (Optional)

<img src="https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/memory-challenge-step-7-attach-a-step-7.webp?fit=max&auto=format&n=gslKLBOHswpMZg4u&q=85&s=53aa7677fe54ba327ee4b021393737dc" alt="Memory Challenge: step 7 — Step 7: Attach a Leaderboard (Optional)" width="2940" height="1840" data-path="images/memory-challenge-step-7-attach-a-step-7.webp" />

* After you have added a data capture to the card, head back to the **success screen**

* **(1)** Edit the **enter competition** call to action

* **(2)** Using the toggle, enable the **leaderboard**

* **(3)** Click on the **edit icon** to set up the leaderboard

  <Accordion title="Setting Up the Leaderboard">
    <img src="https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/memory-challenge-step-7-attach-a-option-a.webp?fit=max&auto=format&n=gslKLBOHswpMZg4u&q=85&s=a9c1febf980c4f6db58194cee36cfee2" alt="Memory Challenge: option a — Step 7: Attach a Leaderboard (Optional)" width="2940" height="1840" data-path="images/memory-challenge-step-7-attach-a-option-a.webp" />

    * **(A)** You can add a **background** to the leaderboard by setting a solid color or uploading an image
    * **(B)** Click here to enter the **Leaderboard title settings**

        <img src="https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/memory-challenge-step-7-attach-a-option-a-2.webp?fit=max&auto=format&n=gslKLBOHswpMZg4u&q=85&s=6c7465d1f4208a8801fb375c57e51611" alt="Memory Challenge: option a — Step 7: Attach a Leaderboard (Optional)" width="2940" height="1840" data-path="images/memory-challenge-step-7-attach-a-option-a-2.webp" />

      * **(a)** Here you can change the **title** of the leaderboard
      * **(b)** You can **label** the cell and clicking on **...**, you can clone and delete this layer
      * **(c)** Edit the **cell size** here
      * **(d)** Using the grid layout, you can select your preferred **text alignment**. The boxes below allow you to alter the **horizontal and vertical padding**
      * **(e)** Alter the **typography** here. Change the title font, size and color
    * **(C)** Click here to enter the **user ranking** title settings
        <Note>
          Follow Steps 3B(a-e).
        </Note>
    * **(D)** Here is where you'll edit the **user ranking settings**

        <img src="https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/memory-challenge-step-7-attach-a-option-d.webp?fit=max&auto=format&n=gslKLBOHswpMZg4u&q=85&s=3d78780a7865e06387ef639a8e133c6d" alt="Memory Challenge: option d — Step 7: Attach a Leaderboard (Optional)" width="2940" height="1840" data-path="images/memory-challenge-step-7-attach-a-option-d.webp" />

      * This is an example of the user's ranking. This will update with the user's data once they have played the Memory Challenge.
      * **(a)** Edit the **cell size** here
      * **(b)** Alter the **horizontal and vertical padding**
      * **(c)** Here you can edit the **typography**. Change the title font, size and color
      * **(d)** Scrolling down, you can add a **background color** to the user ranking and adjust the border radius
    * **(E)** Click here to enter the **leaderboard ranking** title settings
        <Note>
          Follow Steps 3B(a-e).
        </Note>
    * **(F)** Here is where you'll edit the **leaderboard ranking settings**

        <img src="https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/memory-challenge-step-7-attach-a-screenshot.webp?fit=max&auto=format&n=gslKLBOHswpMZg4u&q=85&s=0fe8e9bba44b692cf633e6d64fd5ae20" alt="Memory Challenge: step 7: Attach a Leaderboard (Optional)" width="2940" height="1840" data-path="images/memory-challenge-step-7-attach-a-screenshot.webp" />

        <Note>
          Follow Steps 3D(a-d).
        </Note>

      * **(a)** Here you can adjust the number of **positions** shown on the leaderboard and the configuration for **display names**
      * **(b)** Alter the **spacing** between the rank items using the first setting, and the boxes below allow you to alter the **horizontal and vertical padding**
      * **(c)** Scrolling down, you can edit the **animation**. Changing the **duration** of the scroll (milliseconds) and the **delay**
          <Note>
            This setting works best if you have more than 10 rank items, or if you can't view all the items on one page.
          </Note>
  </Accordion>

* **(4)** Reset the leaderboard to the original settings

### Step 8: Publish your Card

<img src="https://mintcdn.com/komotechnologies/gslKLBOHswpMZg4u/images/memory-challenge-step-8-publish-your-step-8.webp?fit=max&auto=format&n=gslKLBOHswpMZg4u&q=85&s=f5823fbef1c457c1e46b7471a1d0e452" alt="Memory Challenge: step 8 — Step 8: Publish your Card" width="2940" height="1840" data-path="images/memory-challenge-step-8-publish-your-step-8.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 Memory Challenge? 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
* You have set the **timer** for the game
* 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 if you have a competition attached
* All your **result screens** are set up
* 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 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/1tuaX2Afe59_bweb7Vs8jiafYDKFdg2YU/copy" cta="Download Template" />
  </Column>

  <Column>
    <Card title="Card Design Guidelines" color="#F1E52C" icon="cards-blank" href="https://docs.google.com/presentation/d/1-wlzZR7D_9_hemLTc8K8UzEPf6qqVKiVyjnrSd9ap0A/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

**Can I have more than 6 pairs to match?**

Yes, you can add more pairs to the game. See how to add more [here](#step-4-edit-the-gameplay-screen).

**Do I need to add a description?**

A description is to add more context to the game and screens. For the gameplay screen, you could explain what they need to do e.g. Match the pairs in under 30 seconds to win.

**Can I use gifs?**

Yes! You can use animated GIFs as tile images in the memory challenge. Keep in mind that using multiple large GIFs may affect game performance - if you notice slowdowns, try reducing the file size or number of animated tiles.

**How do I add a leaderboard?**

To add a leaderboard, you must have a data capture attached to the card. View [Step 7](#step-7-attach-a-leaderboard) to see how to edit the leaderboard.
