Skip to main content

Achievements šŸ†

Achievements for progress, sessions, content and streak

Sunny Dulay avatar
Written by Sunny Dulay
Updated over 3 weeks ago

Achievements are milestone-based rewards users unlock as they engage with your app. These can be earned by maintaining a streak, completing specific content, joining the community, or reaching other progress milestones.
​


Where Users See Achievements

  • Profile Tab: A dedicated Achievements section displays all available and earned achievements, grouped by category.

  • Achievement Detail Page: Users can tap on an achievement to view its name, criteria, and unlock status.

  • Pop-up Modal: A celebratory message appears when an achievement is earned, including a title, icon, description, and share option.


What You Can Customize

In the Partner Portal under App Settings → Achievements, you can:

  • Upload custom or default icons

  • Set achievement titles and descriptions

  • Define unlock conditions (e.g., specific sessions, progress milestones)

  • Customize the message users see when unlocking an achievement

  • Archive achievements (note: they cannot be deleted)


Types of Achievements

Streak Achievements

  • Unlocked when a user completes a session and their current streak exactly matches a milestone (e.g. 3-day, 7-day).

  • Only unlocks on an exact match — not if the streak is higher or lower.

  • Each streak achievement can be earned once.

Content Achievements

  • Tied to specific sessions or classes.

  • Earned when the associated content is completed.

  • Can be earned multiple times, but only one badge will appear in the user's profile.

Community Achievements

  • Awarded when a user makes their first post or comment.

  • Only unlocks if the action happens after the achievement has been activated.

Subscription Achievements

  • Awarded when a user purchases a subscription.

  • Can be unlocked again on future re-subscriptions, but only one badge will appear in the profile.

Progress Achievements

These include:

  • Session Count Achievements: Earned when the user's total completed sessions exactly matches a set milestone (e.g. 10 sessions).

  • Total Time Achievements: Unlocked when the user’s total session time meets or exceeds a set threshold (e.g. 100 minutes). Each total time achievement can only be unlocked once.


How Unlocking Works

Streak and Session Count Achievements

  • Users must hit the milestone exactly. For example, a 10-session achievement will only unlock when the user completes their 10th session — not their 11th.

  • If a user already passed the milestone before the achievement was created, they will need to match the milestone again to unlock it.

Content, Community, and Subscription Achievements

  • These achievements require the user to complete the action after the achievement has been activated.

  • If the action happened before activation, the achievement will not unlock until the user repeats it.

Total Time Achievements

  • Unlocked when the user's total accumulated time meets or exceeds the milestone.

  • Only awarded once per milestone.


Retroactive Unlocks

When achievements are first enabled in your app:

  • A one-time background check runs the next time a user opens the app.

  • Any existing achievements the user already qualifies for will be unlocked automatically.

  • This retroactive check only happens once. Any achievements added later will not be unlocked based on past activity.

  • To earn newly added achievements, users must complete the action again after the achievement is created


šŸ”§ How to Turn On Achievements in Your App

To activate Achievements for your users, follow these steps in the Partner Portal:

  1. Log into the Breakthrough Partner Portal
    → https://portal.breakthroughapps.io

  2. Go to App Settings
    You’ll find this in the left-hand menu.

  3. Scroll to the ā€œAchievementsā€ section

  4. Toggle ā€œEnable Achievementsā€ to ON

  5. (Optional) Begin customizing your achievements:

    • Upload custom icons

    • Update names and descriptions

    • Configure course-based achievement triggers

    • Set pop-up messages for unlocked achievements

NOTE:
Achievements are only available if your app is running version 6.2 or higher. If you're on an earlier version, please contact us to upgrade.

Did this answer your question?