---
title: "Configure Achievements"
slug: "configure-achievments"
updated: 2026-06-16T09:00:30Z
published: 2026-06-16T09:00:30Z
canonical: "docs.xtremepush.com/configure-achievments"
---

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

# Configure Achievements

To create an Achievement, go to **Ways to Earn** > **Achievements** > **Create**. The sections below describe the configuration for each section of an Achievement.

## Configure Completion Conditions

In the **Completion Conditions** section, specify the user attribute criteria required to earn the achievement. You can add multiple completion conditions and specify user segments to create more complex logic.

Some examples of completion conditions include:

- *Bronze* achievement if *quests_completed* attribute is greater than 20.
- *Silver* achievement if a user’s *current_level* attribute is 5 and *total_deposits_count* attribute is greater than 10.
- *Gold* achievement if a user is in the *VIP* user segment and their *total_deposits_count* attribute is greater than 30.

## Specify Restrictions

Under **Restrictions**, you can specify the user segments eligible to earn the achievement. You can also specify the order of completion, if you’re creating a chain of achievements like Bronze, Silver, Gold.

- **Add Requirement:** This field is similar to **Completion Conditions**, but acts as a filter for user eligibility. For example, you can restrict an achievement to users at *Level 2* or *Level 3*.
- **Order of Completion**: You can select an existing achievement that must be earned before users can qualify for this achievement.

## Specify Rewards

Under **Rewards**, specify one or more rewards that the user receives once the completion conditions are met. See [Loyalty Reward Types](/documentation/docs/loyalty-reward-types) for more information on the different reward types and how to configure them.

## Manage Presentation

Under **Overview**, specify the name of the achievement and manage its visibility

- **Title**: The internal and user-facing name of the achievement.
- **Description**: The description of the achievement that is displayed to users in your widget. For example, *Complete 10 quests to earn the Master Explorer*. You can use markdown formatting to style descriptions with bold, italic, or more.
- **Icon**: Upload an associated icon for the achievement.
- **Visibility**: You can choose between two visibility settings:
  - **Always visible**: The achievement is always shown in the loyalty widget. Users can track their progress, for example, seeing that they have completed 5 out of 20 required quests to get an achievement.
  - **Hidden until completion**: The achievement remains invisible to the user until they fulfill the achievement **Completion Conditions**. This is useful for creating surprise achievements.