Issue Views

Learn how to customize your issue stream in Sentry and quickly see the issues that are most important to you.

Issue views let you customize what shows up in your issue stream so you can quickly see what's most important to you. You have full control over which search query your issue stream renders by default, and which other queries are within a click's reach.

To create your first custom issue view, navigate to the Issues page and click the Add View button. You'll see the following page:

Add View Page

Here, you'll be able to select a view from one of the recommended options or create your own by following the instructions below:

  1. Name your view: Give your view a name that describes the types of issues it will show.
  2. Set your view's search query: Choose the search query that will be applied by default when you select this view. Don't forget to hit enter to apply the query!
  3. Set your view's sort: Select how you want the issues to be sorted in this view (for example, by date, events, and so on).
  4. Set your view's project, environment, and time range filters: Using the filters next to the search bar, select the projects, environments, and time range you want this view to filter by.
  5. Save your view: Click on the ellipsis menu within the tab and select Save Changes.

Views are defined by their serach query, sort, and project/environment/time range filters. Changing any of these parameters won't automatically persist those changes to your view. If you do want to update your view with new changes, click on the ellipsis menu after applying those changes and select Save Changes. You can also hit cmd+s (or ctrl+s on Windows) to save your changes. To discard them, click Discard Changes within the ellipsis menu, or close your Sentry tab without saving.

Unsaved Changes Indicator

Your can reorder your view tabs by dragging and dropping them to whichever position you want them to be in. The first tab will always be your default view and will be what you see when you first open the Issues page.

To rename a view, select it from the tab list. Then, either double click on the view's name or click the ellipsis menu and select Rename, type in a new name, and hit enter.

We built Issue Views in a way that makes them easy to share with people in your organization. To share, just copy the link to your issue view and send it to a fellow org member. The link will take them to a temporary tab that contains the same query and sort as your view. They'll then be able to save the view as their own by clicking Save View, or discard it by clicking Discard. Note, that temporary tabs will not be persisted across page navigations or reloads.

Was this helpful?
Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").