Skip to main content

How to change an Issue's title?

Issue

The issue title in Sentry is not descriptive enough, and I want to show my own text instead.

Applies To

  • All SaaS Customers and Self-Hosted Users

  • Error Monitoring

  • Issue Grouping / Fingerprint Rules

Resolution

Yes, you can change an error issue’s title from the project UI or from the SDK. The issue title follows the most recent event in the issue, so new events can update the title after you change how titles are produced.

Option 1: Fingerprint rules in Sentry (recommended for many cases)

  1. Open your project’s Issue Grouping settings.

  2. Add a fingerprint rule that matches the events you care about.

  3. Set a custom title on that rule.

Example:

logger:my.package.* level:error -> error-logger, {{ logger }} title="Error from Logger {{ logger }}"

Fingerprint rules apply to error issues only. For matchers, variables, and title syntax, see the fingerprint rules documentation.

Option 2: Change the event in the SDK with beforeSend

Use beforeSend to edit the event before it is sent. For error events, Sentry builds the default title from the exception type and value. Update those fields for your SDK’s event shape, or set a custom title field if your SDK supports it.

See your SDK’s filtering documentation for beforeSend examples.

Option 3: Capture a message with the text you want as the title

If you are creating the event yourself and want the issue name to be a specific string, capture a message with that text. In JavaScript:

Sentry.captureMessage("My custom title");

Use the equivalent message-capture API in your SDK. See the SDK usage documentation.

If the title you see still does not match an older event in the same issue, see Issue title does not match the exception.

Did this answer your question?