---
title: Milestones
canonical_url: "https://trophy.so/features/milestones"
description: "A pre-built milestones and app achievements system for consumer web and mobile apps. Mark the moments that matter in every user’s journey, celebrate them in-app, and give lifecycle agents something personal to say, without a custom milestones engine."
---

# Celebrate every milestone in the user journey

Mark the moments that matter with milestones that unlock automatically from in-app events. Configure from a dashboard or MCP and make changes without a new app release.

## A pre-built milestones and achievements engine

Build milestones using a flexible logic engine. Add new milestones and update existing logic without constant releases.

- **No-code milestone logic** — Build metric, streak, and one-off milestones using a flexible milestones engine.
- **Flexible milestone targeting** — Target specific user cohorts based on custom user properties.
- **Update logic without new releases** — Modify milestone logic in the dashboard and push live instantly.

## Turn every milestone into a reason to come back

Lifecycle agents see which milestones each user has earned and which are within reach, and write messages around them, over email or push.

- **Milestones as context** — Every unlock, personal best and near miss becomes something agents can use to encourage users to keep going.
- **Nudge the next milestone** — Agents spot when a user is close to their next milestone and decide whether a message will get them over the line, and when to send it.
- **Celebrate at the right moment** — Each message goes out over the channel that user responds to, at the time they usually use your app.

[See the lifecycle agent](/features/lifecycle-agent)

## See completion rates and difficulty

Track completion rates and monitor unlock difficulty to maintain fairness and balance in your milestones.

- **Maintain balance at scale** — Track completion rates and monitor which milestones are too easily unlocked vs. too difficult.
- **Identify power users** — Spot users completing milestones at a high rate and use their feedback to inform product decisions.

## Built for modern product teams

The customer engagement platform built for the agentic era. Control everything via API or MCP and wire Trophy into your development workflow across multiple environments.

- [Book a demo](/contact-sales)
- [Build with the API](/developers/milestones)

### [First-class APIs for fast-moving teams](/developers/milestones)

Idempotent, retry-safe, time-zone aware. Designed to feel obvious the first time you read the docs.

```ts
// Track workout completions in Trophy
const newState = await trophy.metrics.event('workouts-completed', {
  user: {
    id: user.id,
    tz: 'Europe/London',
  },
  value: 1,
  idempotencyKey: 'workout-123',
})

// React to unlocked achievements in the response
const unlockedAchievements = newState.achievements
```

### [Control everything via MCP](https://docs.trophy.so/mcp)

Connect Trophy to MCP clients like Cursor and Claude Code and configure features without touching the dashboard.

### [Connect your stack via webhooks](/developers/webhooks)

Trigger workflows in third-party tools and internal systems in real time based on changes in Trophy.

### [Develop, test, and deploy across environments](https://docs.trophy.so/platform/environments)

Separate dev, staging, and production environments with their own keys, data, and configuration. Promote changes with confidence.

## Scale with confidence

Trusted by startups and enterprises alike. Scale seamlessly from your first to your millionth user.

### Scale from first user to millionth

Latency, throughput, and uptime that hold up as your user base grows.

### Secure by design

Encryption in transit and at rest, scoped API keys, and privacy-first defaults out of the box.

### Reliable at scale

Failover, backups, and idempotent APIs keep everything dependable under load.

### Serving teams on 4 continents

Powering customer engagement for 1M+ users across the globe with consistent low latency.

## Loved by consumer app teams

*Customers*

Learn why growing product teams are increasing engagement with Trophy.

- [RevisionDojo](https://trophy.so/customers/revisiondojo.md) — With Trophy, RevisionDojo powers a fun and engaging study experience for 350,000 students — integrated in 1 week with a 9% boost in retention.
- [Leal](https://trophy.so/customers/leal.md) — Leal launched white-label leaderboards and XP for its retail merchants in five weeks, lifting loyalty points redemption by 22% in its first pilot.
- [Campfire](https://trophy.so/customers/campfire.md) — Campfire was set up in about an hour with Trophy, helping 1M authors build weekly writing habits with a 22% increase in 14-day retention.
- [Bohemian Research](https://trophy.so/customers/bohemian-research.md) — Bohemian Research powers RewardRoo's energy and spin the wheel for over 500,000 users with Trophy, building 3x faster than in-house.
- [Ritmo](https://trophy.so/customers/ritmo.md) — Ritmo shipped daily giving streaks with Trophy about five weeks after first contact, building giving habits that help everyday people support the causes they care about.
- [Lexioo](https://trophy.so/customers/lexioo.md) — Integrating Trophy took Lexioo just 3 days, helping their English learning app reach 1M+ downloads with consistent daily progress.
- [CyberPatient](https://trophy.so/customers/cyberpatient.md) — CyberPatient added XP, milestones and streaks to virtual clinical training in 5 days, making long cases more engaging for medical students.

## FAQ

### What types of milestones can I build with Trophy?

Trophy's milestones engine supports metric, streak, and one-off milestones using flexible no-code logic in the dashboard. You can target specific user cohorts and update milestone logic live without shipping a new app release.

### How does Trophy decide when a milestone is unlocked?

Trophy evaluates milestone triggers automatically when you send metric events — including metric thresholds, streak lengths, and direct API calls for custom steps. Triggers run in real time without polling or scheduled jobs on your side.

### How do badges relate to milestones in Trophy?

In Trophy, a milestone is the goal a user reaches and each milestone has a badge image that represents it. You configure trigger conditions and badge artwork in the Trophy dashboard, and Trophy hosts badge assets and returns badge URLs for your app UI.

### How do I balance milestone difficulty over time?

Trophy milestone analytics show completion rates so you can monitor which milestones are too easily unlocked versus too difficult. You can identify power users completing milestones at a high rate and use that data to inform product decisions.

### Can I use milestones for onboarding?

Yes. Trophy can unlock milestones when users complete a profile, a first core action, or any other metric-triggered step. You configure those milestone triggers in the dashboard and update them without a new app release.

### How are milestones used in lifecycle messaging?

Trophy's [lifecycle agents](/features/lifecycle-agent) see which milestones each user has earned and which are within reach. They use that to celebrate an unlock or nudge a user toward their next milestone over email or push, and decide for each user whether a message will help and when to send it. There are no milestone templates or triggers to set up.

### Are milestones the same as app achievements?

Yes. Milestones are Trophy's name for app achievements: goals users unlock by using your product, each with its own badge. Trophy's API, SDKs and docs call them achievements, so you'll see endpoints like /achievements/{key}/complete and webhook events like achievement.completed.

Docs: https://docs.trophy.so/features/achievements
