A Release is an object in Amplitude that represents a change in your product. It can represent a major update like the launch of a new feature, or a minor patch to fix a small bug. Amplitude creates them for you automatically, but you can also create them manually.
- At least 100 users must be seen on the new Version
- A release must follow semantic versioning format:
major.minor.patch where .patch is optional
- For example, [Amplitude] Version = 12345 will not automatically create a release, but [Amplitude] Version = 123.45.6 will
- Development projects, i.e Projects that contain names like "Test", "Development", "Staging" etc. are excluded
- Name: The name of the Release. This is visible on Charts and in the Release Timeline view
- Descriptions: What changed in the Release. This is visible in the Release Timeline view and is helpful content for your team.
- Version: The [Amplitude] Version User property that defines the product change. This field allows Amplitude to show you what new Events were introduced in that Release via the Release Report.
- Release Date: The date the Release was shipped.
- End Date: The end date of the release rollout.
- Platform(s): The [Amplitude] Platform(s) this Release is applicable to.
- Visibility: Whether the Release is visible on all Charts or not.
Releases can also be created programmatically by using the Releases API. This allows you to integrate the creation of Releases into your own internal deploy processes.
Viewing Release Reports
In the "About this release" section below, you can see how Users are adopting the latest version of your product.
If there are new events detected in the release, there are pre-built analysis generated in two sections of Breadth and Depth.
Breadth: How many Users are performing events
- Uniques: The number of Unique users performing the events per day
- Totals: The total number of times the events are performed per day
- % Active: The percentage of your active User base, in the given Release, that are performing the new events per day
Depth: How much are Users performing events?
- Median: The median number of times the events are performed per User per day
- Average: The average number of times the events are performed per User per day