Skip to main content

What is a Short ID in Sentry?

Issue

I want to know what a Short ID is in Sentry, how shortId values like MY-PROJECT-1 are formed, whether I can customize them, how they differ from event IDs, and how to search or look them up.

Resolution

A Short ID is the human-readable issue code you see on an issue. It’s also returned as shortId in the API. It identifies an issue within a project.

Format: {PROJECT-SLUG}-{SUFFIX} - for example: MY-PROJECT-1

  • Project slug: The project’s slug, shown in uppercase. This is different from the project’s display name.

  • Suffix: A sequential ID assigned when the issue is created. It’s encoded for display using base32, and you can’t choose or edit it.

A few things to know

  • The suffix is unique within a project, but different projects can use the same suffix. For example, you might have APP-1 and API-1.

  • The full Short ID is unique within an organization because project slugs are unique within the organization.

  • If you change a project’s slug, the Short ID prefix for its issues changes too. Changing only the project name does not.

  • A Short ID is not an event ID. An event ID identifies a single event, while a Short ID identifies the issue (a group of events).

Searching by Short ID

To find an issue by Short ID, use the issue field in search. For example:

issue:MY-PROJECT-1

See Issue Properties for more details.

Resolving a Short ID via the API

To resolve a Short ID and get the associated project and group details, you can use Resolve a Short ID.

Did this answer your question?