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

# Challenges

**Challenges** are time-limited events in which learners compete to answer a series of questions quickly and correctly, earning points and leaderboard rankings (if enabled).

<Note>
  **NOTE:** Battles are built on questions from the shared question bank. If you haven't set up questions yet, see [**Questions**](https://docs.opigno.com/questions) before proceeding.
</Note>

<Note>
  **NOTE:** Only users with the **administrator** and **content editor** roles can access challenges. Content managers only see challenges for their hierarchy level or below.
</Note>

Challenges are managed under **Tools > Gamification** in the left-hand menu.

### Dashboard

<img src="https://mintcdn.com/connect-i/uxIbJsr4IRda8kXR/images/image_2026-04-02_173202419.png?fit=max&auto=format&n=uxIbJsr4IRda8kXR&q=85&s=fb8add6a3749c3839ea5d79b8f454795" alt="Image 2026 04 02 173202419" title="Image 2026 04 02 173202419" className="mx-auto" width="1695" height="768" data-path="images/image_2026-04-02_173202419.png" />

The dashboard table shows all the challenges with the following attributes:

* **Challenge ID**
* **Title**
* **Start and end dates**: The challenge's opening and closing dates
* **Hierarchy level restriction**: If no hierarchy is selected, all users can access the challenge.
* **Challenge finishers**: The number of learners who completed the challenge. Click the number to view the complete list of participants, their ranking from highest to lowest score, and completion dates.
  <img src="https://mintcdn.com/connect-i/uxIbJsr4IRda8kXR/images/image_2026-04-02_184145761.png?fit=max&auto=format&n=uxIbJsr4IRda8kXR&q=85&s=c151903d46bca83e565af31455d442fa" alt="Image 2026 04 02 184145761" title="Image 2026 04 02 184145761" className="mr-auto" style={{ width:"59%" }} width="736" height="476" data-path="images/image_2026-04-02_184145761.png" />
* **Status**: Published/Unpublished
* **Owner** (creator)
* **Last update date**
* **Action**: Edit and Publish/Unpublish
  <Note>
    **NOTE:** You cannot edit a challenge after its start date.
  </Note>

### Creating a new challenge

Click the **Add challenge** button to open the challenge creation interface. The process consists of two steps.

#### Step 1. Adding basic settings

<img src="https://mintcdn.com/connect-i/uxIbJsr4IRda8kXR/images/image_2026-04-02_174738761.png?fit=max&auto=format&n=uxIbJsr4IRda8kXR&q=85&s=6f1d21b296d625eaf42a13719fb8548e" alt="Image 2026 04 02 174738761" width="1361" height="2389" data-path="images/image_2026-04-02_174738761.png" />

On this page, you can set the general settings for the new challenge:

**Name**: The challenge title visible to learners. **It is a required field.**

**Description**: Explain the challenge's purpose and rules. **It is a required field.**

**Image**: Upload, select, or generate a visual representing the challenge.

**Validity dates**: Set the opening and closing dates, i.e., when the challenge becomes available to learners and when it ends. **It is a required field.**

**Conditions**:

<img src="https://mintcdn.com/connect-i/uxIbJsr4IRda8kXR/images/image_2026-04-02_175758861.png?fit=max&auto=format&n=uxIbJsr4IRda8kXR&q=85&s=6df3dcdd8e41826f1fac5d82ca304249" alt="Image 2026 04 02 175758861" title="Image 2026 04 02 175758861" className="mr-auto" style={{ width:"62%" }} width="809" height="556" data-path="images/image_2026-04-02_175758861.png" />

* **Hierarchy level**: Restrict access to the specific hierarchy level so only users at this level or below can participate; leave empty to allow all users.
* **Randomize questions**: Enable the shuffle of question order for each learner.
* **Display ranking and leaderboard**: Enable the display of competitive standings.
  * **Anonymize names**: If ranking display is enabled, you can set the leaderboard to show only learners' initials instead of full names.
* **Display questions correctly answered**: Enable showing the status of each question's answer (correct/incorrect) at the end.

**Score calculation:**

<img src="https://mintcdn.com/connect-i/uxIbJsr4IRda8kXR/images/image_2026-04-02_180557251.png?fit=max&auto=format&n=uxIbJsr4IRda8kXR&q=85&s=13e4307f6e4299548aab346532618689" alt="Image 2026 04 02 180557251" title="Image 2026 04 02 180557251" className="mr-auto" style={{ width:"55%" }} width="694" height="624" data-path="images/image_2026-04-02_180557251.png" />

* **Points for correct answer per question**: Base points awarded for each correct response. **It is a required field.**
* **Bonus points for speed**: If enabled, learners earn extra points based on the number of seconds remaining from the question's time limit. If the multiplier is set to 0, the time-based bonus is disabled.
  <Note>
    **NOTE:** The time limit for each question is **set individually** when creating or editing a question. To learn more about creating new questions, see [**Creating a new question**](https://docs.opigno.com/challenges#creating-a-new-question). Bonus points are awarded **only for correct answers**.
  </Note>

Click **Next step** to save the settings and proceed to adding the questions.

#### Step 2. Adding questions

<img src="https://mintcdn.com/connect-i/uxIbJsr4IRda8kXR/images/image-8.png?fit=max&auto=format&n=uxIbJsr4IRda8kXR&q=85&s=306d316bf197d71b2257082b8989094d" alt="Image" title="Image" className="mx-auto" width="1259" height="464" data-path="images/image-8.png" />

On this next step, you can add existing questions to the challenge or create new ones.

<Info>
  To learn more about creating new questions, see [**Creating a new question**](https://docs.opigno.com/challenges#creating-a-new-question).
</Info>

Click **Select from existing** to open the list of all the available questions and check the questions you want to add. You can search for them by title and sort the list in ascending or descending order by question ID or title.

To discard a single selection, click **X** next to its tag. To discard all selections, click **Clear all** to the right of the tags. To confirm your selection, click **Add question(s)**.

<img src="https://mintcdn.com/connect-i/uxIbJsr4IRda8kXR/images/image-9.png?fit=max&auto=format&n=uxIbJsr4IRda8kXR&q=85&s=9260e8450ab84ba61649a081303694b0" alt="Image" title="Image" className="mx-auto" style={{ width:"78%" }} width="1130" height="620" data-path="images/image-9.png" />

After configuring the challenge, click **Save & publish** to publish it. To discard the changes and return to the previous step, click **Back**.
