Set Up

Setting up releases fully is a multi-step process, and is adaptable to your organization's needs.

Configure Your SDK

With your SDK configured to provide a release identifer and enable session tracking, you can monitor both releases and release health.

Notify Sentry

Notifying Sentry of a release enables auto discovery of which commits to associate with a release and identifies what we consider "the most recent release" when searching in In addition, telling Sentry of a release helps identify new issues, regressions, and whether an issue is resolved in the next release. You do not need a repository integration for any of these features, though we recommend installing a repository integration for efficiency.

Using Release Automation

If you're using Release Automation, let Sentry know you’ve deployed by sending an additional request after creating a release:

sentry-cli releases --org ORGANIZATION_SLUG deploys VERSION new -e ENVIRONMENT

NOTE: Make sure you have a token properly configured.

You can also use our API to create a deploy.


When you notify Sentry that you've deployed a release to a new environment, we can automatically send an email to Sentry users who have committed to the release being deployed.

release ui

Enable Suspect Commits

With an additional repository integration or manual commits, you can also track suspect commits.

  1. Installing a repository integration (this step is optional, but highly recommended)
  2. Associating commits to a release by adding to your release management script when you build a release.
You can edit this page on GitHub.