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

# Milestones

> Define adoption milestones to track how successfully your users are starting to use your application.

## Why it Matters

Milestones are similar to user segments, but they are used to define when a user has reached a specific level of adoption in your application.
Unlike user segments, milestones are reached and completed only once and remain completed forever (or until the completion conditions change).

## Requirements

To set up your milestones, you'll typically want users to visit a specific page, perform a particular action, or use a certain feature. Here are some potential starting points to consider:

* **Page Tags**: tag application pages to track page views and view durations. ([Learn More](/events/pages))
* **Feature Tags:** tag application features to track feature usage. ([Learn More](/events/features))
* **Custom User/Company Properties:** tag users and companies with custom properties to track user and company attributes. ([Learn More](/settings/properties))

## Create a Milestone

We can create a new milestone by navigating to <a href="https://app.guidewhale.com?to=/milestones" target="_blank">Dashboard > Milestones</a>, where we can see a list of existing user milestones and a `Create Milestone` button on the top right of the page.

<iframe id="gwhale-531b954d-1341-49fa-95d5-6a396b692222" loading="lazy" src="https://app.guidewhale.com/public/prod-4427583c/guides/531b954d-1341-49fa-95d5-6a396b692222/embed?aspectRatio=1.61197" title="Create a new milestone" width="100%" style={{aspectRatio: "1.45", background: 'transparent'}} referrerpolicy="strict-origin-when-cross-origin" frameborder="0" allow="clipboard-write; fullscreen; picture-in-picture;" webkitallowfullscreen="webkitallowfullscreen" mozallowfullscreen="mozallowfullscreen" allowfullscreen="allowfullscreen" allowtransparency="true" />

## Configuration

Milestones are always active and updating them will update them live.

* **Milestone Completion Rules:** rules that the user must meet in order to complete this milestone. After rules are updated, you will see the list of users who have completed the milestone. When a rule is modified, but not saved, you will see a preview of users who fit your current configuration.
* **Core Milestone:** determine if this milestone is an important core milestone. Core milestone completion will allow you to measure user application adoption health.
* **Lifecycle Stage:** group different milestones into user lifecycle stages, whether they are currently onboarding, being retained, or inside another lifecycle stage.
* **Expected Completion Time:** define the expected time it takes for a user to complete this milestone.
* **Title:** milestone title for quick identification.
* **Description:** milestone description for other team members to better understand this milestone.

## Analytics

Milestone analytics will show you how many users have completed the milestone in the selected time period.

* **Total Users:** how many total users have been identified.
* **Total Completions:** how many total users have completed the milestone in total.
* **Completions In Selected Period:** how many users have completed the milestone inside the selected time period.
* **Period Average Completion Time:** how long users took to complete the milestone on average inside the selected time period.
* **Milestone Completions Chart:** show milestone completions over time for the selected time period.
* **Average Completion Time Chart:** show average time it took users to complete the milestone over time for the selected time period.
* **Milestone Completions Table:** shows all users who have completed the milestone, when they completed it and how long it took them to complete it.