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:
Log into the Breakthrough Partner Portal
ā https://portal.breakthroughapps.ioGo to App Settings
Youāll find this in the left-hand menu.Scroll to the āAchievementsā section
Toggle āEnable Achievementsā to ON
(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.