> 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/global-challenge-settings.md).

# Global Challenge Settings

The Global Challenge Settings allow you to customize how challenges are presented across your site and in communications with your customers. Adjust these settings to align the challenge experience with your brand and user preferences.

**Settings Overview**

1. **Challenge Alternate Name (Singular):**
   * **Description:** Customize the term used for a single challenge across your site and in emails.
   * **Purpose:** Replace the default term 'Challenge' with your preferred name to better fit your branding or thematic focus.
2. **Challenge Alternate Name (Plural):**
   * **Description:** Customize the term used for multiple challenges across your site and in emails.
   * **Purpose:** Replace the default term 'Challenges' to maintain consistency with your alternate singular name and branding.
3. **Join Button Text:**
   * **Description:** Set the text displayed on the button prompting users to join a challenge.
   * **Purpose:** Replace the default 'JOIN' text with a more engaging or relevant call-to-action to encourage participation.
4. **Display Upcoming Challenges This Many Days Before They Begin:**
   * **Description:** Define how many days in advance upcoming challenges are displayed on the Challenges listing page.
   * **Purpose:** Control visibility of upcoming challenges. For example, setting this value to 14 will show challenges starting within the next two weeks. Setting it to 0 will only display challenges that have already started.
5. **No Visible Challenges Message:**
   * **Description:** Enter a message to be shown on the 'Challenges' page when no challenges are listed for the customer’s selected location.
   * **Purpose:** Provide a clear message or call-to-action when there are no active challenges available, ensuring customers understand the absence of challenges.
6. **No Joined Challenges Message:**
   * **Description:** Enter a message to be shown on the 'My Challenges' page if the customer has not joined any challenges.
   * **Purpose:** Encourage users to join challenges or explore other areas of engagement when they have not yet participated in any challenges.

**Applying Global Challenge Settings**

To adjust these settings:

1. **Go to the Dashboard:** Navigate to the "Settings" section from the main dashboard.
2. **Select "Challenges":** Click on "Challenges" to access the global settings page.
3. **Edit Settings:** Click on "Global Challenge Settings" toward the top of the page and make desired changes to the global settings fields.
4. **Save Changes:** Ensure to save your adjustments to apply them across your site and communications.

These settings help tailor the challenge experience to your brand and customer needs, enhancing engagement and clarity.


---

# 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/global-challenge-settings.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.