Skip to content

Commit

Permalink
Apply Liza's suggestions 🙏
Browse files Browse the repository at this point in the history
Co-authored-by: Liza Mock <liza.mock@sentry.io>
  • Loading branch information
MichaelSun48 and lizokm authored Sep 18, 2024
1 parent e2fba07 commit 3517775
Showing 1 changed file with 18 additions and 19 deletions.
37 changes: 18 additions & 19 deletions docs/product/issues/custom-views/index.mdx
Original file line number Diff line number Diff line change
@@ -1,55 +1,54 @@
---
title: Custom Issue Views
sidebar_order: 36
description: "Learn how to customize your issue stream in Sentry."
description: "Learn how to customize your issue stream in Sentry and quickly see the issues that are most important to you."
---
{/* TODO(msun) Figure out if this is the order we want custom views docs to appear in the sidebar */}

Custom issue views enable you to tailor the issue stream experience in Sentry to your personal environment. With custom views, you have full control over which search query your issue stream renders by default, and what other queries are within a click's reach.
Custom 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.


## Creating your first view
## Creating Your First View

To create your first custom issue view, navigate to the **Issues** page and click on the **Add View** button. You'll be greeted by this page:
To create your first custom issue view, navigate to the [**Issues**](https://sentry.io/orgredirect/organizations/:orgslug/issues/) page and click the **Add View** button. You'll see the following page:

{/* TODO(msun) Insert image here once it's been updated for EA (current state of custom views is LA-specific) */}

Select a view from one of the recommended options, or create your own view from scratch by following these instructions:
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 descriptive name that reflects the issues it will display.
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 (e.g., by date, events, etc.)
4. **Save your view**: To save your view, click on the ellipsis menu within the tab and select **Save Changes**.
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. **Save your view**: Click on the ellipsis menu within the tab and select **Save Changes**.

<Note>
If you previously had a default custom saved search, it will be automatically converted to a custom view and will appear as your first view automatically. Any other saved searches you created will be temporarily available in the **Add View** menu. Please save them as views if you wish to keep them.
If you had a default custom saved search, it'll be converted to a custom view tab and will appear as your first view automatically. Any other saved searches you created will be temporarily available in the **Add View** menu. Please save them as view tabs if you'd like to keep them.
</Note>

## Customizing your Views
## Customizing Your Views


#### Updating view queries and sorting

Views are primarily defined by their search query and sort order. When the query or sort is updated, an **unsaved changes indicator** (shown below) will appear above the tab's ellipsis to indicate that the current query/sort have diverged from the view's orginal query/sort. You can overwrite the view's original with the new query/sort by clicking the ellipsis menu and selecting **Save Changes**. If you want to discard your changes, you can similarly click **Discard Changes** within the ellipsis menu, or close your Sentry tab without saving.
### Updating View Queries and Sorting

Views are defined by their search query and sort order. If you want to update either the query or the sort, you'll see an **unsaved changes indicator** (shown below). To save your changes, click the ellipsis menu and select **Save Changes**. To discard them, click **Discard Changes** within the ellipsis menu, or close your Sentry tab without saving.
{/* TODO(msun) figure out how to resize this */}
![Unsaved Changes Indicator](./img/custom_views_unsaved_changes_indicator.png)


#### Reordering views and setting a default view
### Reordering Views and Setting a Default View

Your views can be reordered in the tab list by dragging them to your desired position. You can set any of your views to be the default view that appears when you navigate to the **Issues** page. To do this, simply drag your view to the first position in the tab order.
Your can reorder your view tabs by dragging them to where you want them to be. The first tab will always be your default view and will be what you see when you first open the **Issues** page.


#### Renaming views
### Renaming Views

To rename a view, first select it from the tab list. Then, either double click on the view's name or click the ellipsis menu and select **Rename**, then type in a new name and hit enter.
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.


## Sharing views
## Sharing Views

Views were built specifically with sharability in mind. To share a view with someone else within your organization, simply copy the link to your issue view and send it to them. Anyone that clicks on the link will be navigate to a **temporary tab** that contains the same query and sort as your view. They can then save the view as their own by clicking **Save View**, or discard it by clicking **Discard**
We built 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**.



Expand Down

0 comments on commit 3517775

Please sign in to comment.