> For the complete documentation index, see [llms.txt](https://docs.perkville.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perkville.com/features/settings/challenges.md).

# Challenges

**Overview**

Perkville's Challenges feature is designed to boost customer engagement and drive interaction with your business through targeted and seasonal initiatives. By setting up various types of challenges, businesses can motivate customers to explore more products and services to earn points.

{% hint style="info" %}
**No manual Join required with automatic enrollment**

Enable **Automatically enroll eligible customers** in the challenge settings before launching. An eligible customer's first qualifying activity enrolls them and counts toward progress. They can earn configured milestone rewards as they reach each goal without selecting **Join**. [See automatic enrollment setup](https://docs.perkville.com/features/challenges/automatic-enrollment-into-challenges.md).
{% endhint %}

**Managing Challenges**

To access and manage challenges:

1. **Navigate to the Dashboard:** From the main dashboard, go to "Settings" in the left-hand navigation menu.
2. **Select "Challenges":** Click on "Challenges" in the settings menu to open the challenges management page.

**Types of Challenges**

Businesses can create and customize the following types of challenges:

* **Seasonal Challenges:** Design challenges that align with seasonal events or holidays to attract customer participation during specific times of the year.
* **New Member Challenges:** Engage new members with challenges tailored to introduce them to your products or services, encouraging early interaction and retention.
* **Targeted Challenges:** Develop challenges aimed at specific customer segments to drive engagement with particular offerings or promotions.

#### Key Actions on the Challenges page

* **Create Challenges**: Businesses can set up seasonal, new member, or targeted challenges to excite customers and encourage them to engage with more products or services.
* **View and Preview Challenges**: The main Challenges settings page lists the following types of challenges and provides buttons to preview them:
  * **Draft Challenges**: Challenges that are in progress but not yet active.
  * **Current Challenges**: Active challenges that are currently available for participation.
  * **Expired Challenges**: Challenges that have ended and are no longer active.

These challenges are designed to excite customers and enhance their interaction with your business, ultimately fostering greater loyalty and increased usage of your services.

{% hint style="info" %}
**Continue reading**

Review the global defaults, then configure each challenge's enrollment, activities, and rewards in the following guides.

**Start with** [**Global Challenge Settings**](https://docs.perkville.com/features/settings/challenges/global-challenge-settings.md) **→**
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.perkville.com/features/settings/challenges.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
