> ## Documentation Index
> Fetch the complete documentation index at: https://www.checklyhq.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Views

> Save the filters of a list in the Checkly app as a named view, keep it private or share it with your account, and arrange your own views bar.

A view is a named set of filters for a list in the Checkly app. Views sit in a bar above the filter field. Each view is private or shared with the account. Every member arranges their own bar.

![Monitors page with the All, Passing, Degraded and Failing views and a private view in the bar, each showing a counter, above the filter field](https://mintcdn.com/checkly-422f444a/AcOqM04zEhs6UkZf/images/views/monitors-view-tabs.png?fit=max\&auto=format\&n=AcOqM04zEhs6UkZf\&q=85\&s=b3cf0317d8847f42ba97de2106f675af)

## Where you can use views

| Screen | [Counter](#counters) |
| - | - |
| Monitors | Total, Passing, Degraded or Failing |
| Heartbeats | Total, Passing or Failing |
| Test sessions | None |

Each screen has its own views. A view saved on one screen doesn't show on another.

A view stores the [filters](https://www.checklyhq.com/docs/platform/filters.md) in the filter field, their groups and the time range.

**Monitors:** every account starts with shared [Passing, Degraded and Failing](#passing-degraded-and-failing-on-monitors) views.

**Test sessions:** the views bar sits below the page tabs. It shows on the **Test Sessions** tab only. The **Error Groups** tab has its own filters and no views. Switching between the two tabs clears the filters.

![Test sessions list with the views bar below the page tabs and the filter field underneath](https://mintcdn.com/checkly-422f444a/AcOqM04zEhs6UkZf/images/views/test-sessions-view-tabs.png?fit=max\&auto=format\&n=AcOqM04zEhs6UkZf\&q=85\&s=f4cd9b66193714cb736a2666e6ec492d)

## How views work

* **All** is always first in the bar. It shows the list without filters.
* Selecting a view replaces the filters on screen with the view's filters.

## Create a view

New views are private. Only you see them until you [share them](#private-and-shared-views).

Set filters while **All** is selected. A **Create view** button shows next to the filter field. Click it, type a name and press Enter. Press Escape or click elsewhere to cancel.

![All selected with two filters set, and the Create view button next to the filter field](https://mintcdn.com/checkly-422f444a/AcOqM04zEhs6UkZf/images/views/create-view.png?fit=max\&auto=format\&n=AcOqM04zEhs6UkZf\&q=85\&s=c1980a9d78db3c6da1a35dc9001c0e99)

## Change a view's filters

When the filters on screen differ from the selected view, these buttons show next to the filter field:

* **Reset** puts the view's saved filters back.
* **Save as new** saves the current filters as a new private view.
* **Save view** updates the view. It only shows when you can edit the view.

![A selected view with a changed filter, and the Reset, Save as new and Save view buttons next to the filter field](https://mintcdn.com/checkly-422f444a/t9LSA2YNdIQJuwL6/images/views/view-changes.png?fit=max\&auto=format\&n=t9LSA2YNdIQJuwL6\&q=85\&s=819d8d0c8d7d4b08ee1ad802fffaa628)

## View options

**View options** is the three-dot button on the selected view. Click it to act on that view. Right-click any view in the bar to open the same menu without switching to it.

The menu first says whether the view is private or who shared it. Then it lists the actions you're allowed to take:

* **Counter** picks the number the view shows, on screens that have [counters](#counters).
* **Rename** edits the name in place. Double-clicking a view does the same.
* **Move left** and **Move right** reorder your bar.
* **Hide from bar** or **Show in bar**.
* **Share with account** or **Make private**.
* **Delete**. Deleting a shared view asks for confirmation, because it removes the view for everyone.

![The View options menu of a private view, with the Counter submenu open and Failing selected](https://mintcdn.com/checkly-422f444a/t9LSA2YNdIQJuwL6/images/views/view-options-menu.png?fit=max\&auto=format\&n=t9LSA2YNdIQJuwL6\&q=85\&s=4e9e4909755f155f1dc15d6bfe197e05)

## Private and shared views

A **private** view belongs to you. You can rename it, change its filters or delete it. Nobody else sees it.

A view **shared with the account** shows in the bar of every member who can see shared views. To share one of your private views, choose **Share with account** in its menu.

**Make private** turns a shared view back into a private one. It goes back to the member who shared it if they're still in the account. Otherwise it becomes yours.

If a teammate deletes the view you're looking at, or makes it private, its filters stay on screen with **All** selected. Click **Create view** to keep them.

### Permissions

Your own private views and the order of your bar need no permission. Shared views need these:

| Permission | What it allows | Built-in roles |
| - | - | - |
| View shared views | See the views shared with the account, on their screens and in **Account settings > Views** | All roles |
| Share views | Share one of your own views with the account | Owner, Admin, Read & Write |
| Edit shared views | Rename shared views and change their filters and counter | Owner, Admin, Read & Write |
| Delete shared views | Delete shared views, or make one private again | Owner, Admin, Read & Write |

[Custom roles](https://www.checklyhq.com/docs/admin/team-management/custom-roles.md) (beta) can grant these permissions one by one when enabled for your account. They're listed under **Shared views**. See [Team member roles](https://www.checklyhq.com/docs/admin/team-management/overview.md#team-member-roles) for the built-in roles.

## Arrange your bar

Your bar is yours. Reordering or hiding views changes only your own bar. Your teammates' bars stay as they are.

* **Reorder:** drag a view, or use **Move left** and **Move right**. **All** stays first.
* **Hide:** choose **Hide from bar**. Hiding the selected view switches you back to **All**.
* **Find hidden views:** open the menu at the end of the bar. Its label is the number of views it holds, such as **+3**. Hidden views are listed under **Hidden**. Views that don't fit the width of the screen are listed there too.
* **Show a hidden view:** select it in that menu. It goes back to the end of your bar. **Show in bar** does the same without selecting it.

Right-clicking a view in that menu opens its options too.

![The menu at the end of the views bar, listing views that don't fit and two views under Hidden](https://mintcdn.com/checkly-422f444a/AcOqM04zEhs6UkZf/images/views/more-menu.png?fit=max\&auto=format\&n=AcOqM04zEhs6UkZf\&q=85\&s=7fdb47c018a4225f1aebb933534e3d15)

> [!NOTE]
>
> On a phone, the bar scrolls sideways. Press and hold a view to drag it. Use **View options** instead of right-clicking.

## Share a link to a view

The URL holds the selected view and every filter it applies. Copy it from your browser to send the same list to anyone in the account, even when the view is private.

* **A view you can see** opens selected. If the link's filters differ from the view's saved filters, the view shows as changed. **Reset** puts the saved filters back. **Save view** stores the link's filters in the view if you can edit it. A hidden view goes back into your bar.
* **A view you can't see**, such as another member's private view or a deleted view, opens with **All** selected and the link's filters on screen. Click **Create view** to keep them as your own private view.
* **A link that names only the view**, like the one **Open** uses in **Account settings > Views**, opens the view with its saved filters. So does a link that adds only a time range. The link's range then replaces the view's.

After you save a view, the address bar shows the view and its filters in their shortest form. Following a view link adds one entry to your browser history. **Back** returns to the page you opened it from.

## Manage shared views

**Account settings > Views** lists every view shared with the account, across all screens, with its filters, who shared it and when it last changed. Search by name, or filter by **Page** and **Shared by**.

**Shared by** shows **Checkly** for the views every account starts with. It shows **Former member** for views shared by someone who has left the account.

Each view's menu has:

* **Open** takes you to the view's screen with the view selected and its filters applied.
* **Rename**, with **Edit shared views**.
* **Delete**, with **Delete shared views**.

Private views don't appear here. The page is available to members with **View shared views**.

![Account settings Views page with a table of shared views showing their name, page, filters, who shared them and when they were last updated](https://mintcdn.com/checkly-422f444a/AcOqM04zEhs6UkZf/images/views/account-settings-views.png?fit=max\&auto=format\&n=AcOqM04zEhs6UkZf\&q=85\&s=9bd2f37aeba62794dbda2a6aefadf8c6)

## Limits

* Each member can keep **10 private views** per screen. At the limit, **Create view** and **Save as new** are disabled. Sharing a view frees a slot.
* Each account can have **10 shared views** per screen.
* Making a shared view private fails if the member it goes to already has 10 private views on that screen.
* View names can be up to 200 characters.

## Counters

On screens with counters, a view can show a number next to its name. Pick it in **View options > Counter**. On Monitors, the choices are:

* **None**
* **Total**: every check the view shows.
* **Passing**, **Degraded** or **Failing**: the active checks in that state.

On Heartbeats, the choices are **None**, **Total**, **Passing** and **Failing**.

The selected view counts what's on screen. That count includes changes you haven't saved. Every other view counts its saved filters. A count of zero shows in gray.

New views start with no counter. The counter is part of the view. Everyone sees the same counter on a shared view. Changing the counter of a shared view needs **Edit shared views**.

Test sessions has no counters.

## Passing, Degraded and Failing on Monitors

Every account starts with three shared views on Monitors: **Passing**, **Degraded** and **Failing**. Each one filters on its status and counts those checks.

They behave like any other shared view. You can rename them, change their filters or counter, hide them from your bar, or delete them. A deleted one doesn't come back. You can recreate it from the **Status** filter.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.