Skip to main content

Achievements 🛡️

Achievements for progress, sessions, content and streak

Sunny Dulay avatar
Written by Sunny Dulay
Updated over a week ago

UPDATE: 🏆 New in 6.4: Progress-Based Achievements (see below)

Breakthrough 6.2 introduces Achievements, a powerful new feature to reward user progress, increase motivation, and boost engagement inside your app. As a partner, you can fully customize the achievement experience to match your brand and community goals.


🌟 What Are Achievements?

Achievements are milestone-based rewards users unlock as they engage with your app. From maintaining a streak to completing courses or joining the community, achievements provide positive reinforcement and a sense of accomplishment.


🎯 Where Users See Achievements

  • Profile Tab: A new Achievements section shows all available and earned achievements, grouped by category (Streaks, Courses, Community).

  • Achievement Detail Page: Tapping any achievement opens a screen showing its name, criteria, and status (locked/unlocked).

  • Pop-up Modal: When a user unlocks an achievement, they see a celebratory pop-up with:

    • The achievement name and icon

    • A short description

    • A “Share” button to post on social media


🛠 What You Can Customize

In the Partner Portal, you’ll find a new section under App Settings for Achievements where you can:

  • Upload a custom icon (or use a system-generated one)

  • Edit the achievement name

  • Add a short description

  • Configure the unlock condition (for course completion only)

  • Customize the success message title and description shown in the pop-up

  • Archive an achievement (deleting is not supported to preserve user data)

🔐 Note: If no icon is uploaded, a default one will be applied based on your app branding.


Types of Achievements Available

Streak-Based (Auto-tracked)

These unlock when a user maintains a usage streak:

  • 3-day

  • 7-day

  • 10-day

  • 30-day

  • 50-day

  • 100-day

  • 365-day

  • 500-day

  • 1000-day

Content-Based

  • Course Completion (Configurable by partner)

Community Engagement

  • First community post

  • First reply to a post

  • Becoming an App Subscriber


🔧 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

🏆 New in 6.4: Progress-Based Achievements

You can now reward your users based on the number of sessions completed or total time spent in the app — introducing Progress-Based Achievements!

This is a powerful new way to celebrate user consistency, deepen engagement, and build long-term habit formation in your app.

What Are Progress-Based Achievements?

Previously, achievements in your app were only available for streaks or one-time milestones. With this new feature, you can now:

  • Track total number of sessions completed (e.g. Complete 5 sessions)

  • Track total minutes spent in the app (e.g. Complete 120 minutes of content)

This gives your users visible goals to work toward — and keeps them coming back for more!

✨ Why This Matters

This update gives you more flexibility to design personalized, motivating experiences for your users.

✅ Track progress over time — not just streaks

✅ Reward users for showing up consistently, even if not every day

✅ Reinforce core programs by aligning achievements to them

✅ Create a sense of accomplishment and momentum

You can even stack multiple achievements to build a full recognition system in your app — just like in popular wellness products like Headspace, Peloton, and Calm.

🛠 How to Set Up Progress-Based Achievements

💡 Note: This feature is available in Breakthrough version 6.4 and above.

To add a progress-based achievement:

  1. Go to the Partner PortalApp SettingsAchievements

  2. Click Add Achievement

  3. Set the Type to Progress

  4. Choose a Sub-Type:

    • Session = number of completed sessions

    • Minutes = total time spent in content

  5. Set the Condition (e.g. Complete 5 sessions)

  6. Upload an icon (PNG, 300x300px, transparent background)

  7. Add a title and short description

  8. Click Add

📸 Here’s what that looks like in the Portal:

We recommend adding at least 2–3 progress milestones for each major program or content flow (e.g. 3 sessions, 10 sessions, 30 minutes, 100 minutes) to build in motivation and habit reinforcement.

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?