Skip to main content
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 fieldMonitors page with the All, Passing, Degraded and Failing views and a private view in the bar, each showing a counter, above the filter field

Where you can use views

Each screen has its own views. A view saved on one screen doesn’t show on another. A view stores the filters in the filter field, their groups and the time range. Monitors: every account starts with shared Passing, Degraded and Failing 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 underneathTest sessions list with the views bar below the page tabs and the filter field underneath

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. 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 fieldAll selected with two filters set, and the Create view button next to the filter field

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 fieldA selected view with a changed filter, and the Reset, Save as new and Save view buttons next to the filter field

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.
  • 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 selectedThe View options menu of a private view, with the Counter submenu open and Failing selected

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: Custom roles (beta) can grant these permissions one by one when enabled for your account. They’re listed under Shared views. See 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 HiddenThe menu at the end of the views bar, listing views that don't fit and two views under Hidden
On a phone, the bar scrolls sideways. Press and hold a view to drag it. Use View options instead of right-clicking.
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 updatedAccount settings Views page with a table of shared views showing their name, page, filters, who shared them and when they were last updated

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.