# Views
A list of issues in recursiva is a query plus display settings: which issues, how they are grouped and sorted, and which properties each row shows. A saved view keeps all of that under a name. A view can be yours alone or shared with everyone in the workspace, and it can show as a tab in the projects it covers.
All issues
Each project's Issues page opens on the All issues tab. It is built in. You can filter it and change its display, but those changes are temporary. Clear takes the filters back. To keep the changes, save them as a new view.
List or board
V switches between List and Board, as does the switch in the header. This choice is yours, on this device: it is not part of a view and does not change what others see.
A view's own page shows a board only when the view covers one project. Across projects there is no board, because each project has its own states.
Filters: the View panel
The View panel is where you filter a list and save it. Open it with F or E, or with the View button in the header. / opens it with the cursor in the query field.
- Filters. One line per field, each with "is" or "is not" and its values. Each value in the menu shows how many issues it would leave. Add filter adds a line. The panel shows how many issues match.
- Query. Under the filters is the same list as one line of the query language. The line and the filter lines change together.
The list changes as you edit. Esc closes the panel and keeps your changes. So does a click outside it. A new view's panel stays open until you create the view; closing it drops the draft.
The list's query is also in the page address as ?q=. A link with it opens the same list.
Display
Display sets how the list looks. Open it with ⇧V, or the Display button beside View.
- Group by: States, State groups, Priority, Labels, Assignees, Created by, Agent, Projects, Cycles, Parent, None. Projects is offered only on a list across projects.
- Sub-group by: the board's rows (swimlanes). Board only.
- Order by: Manual, Last created, Last updated, Start date, Due date, Priority. This is the same setting as
order:in the query. - Sub-issues: show sub-issues as rows of their own.
- Empty groups: show groups with no issues.
- Properties: which properties each row or card shows: ID, Assignees, Start date, Due date, Labels, Priority, State, Cycle, Sub-issue count, Created on, Updated on.
Reset takes Display back to the saved view's settings, or to the default on All issues. Display's changes are saved with the view.
Save a view
- New view:
⇧Non a list, or New view on the Views page. A new view starts from the list on screen. In a project, it starts narrowed to that project. - Save as new view:
⇧⌘S(Ctrl+Shift+S), or in the panel's ⋯ menu. It copies the current view. - Save:
⌘S(Ctrl+S) saves your changes to the view. Revert drops them. - Create view:
⌘↵(Ctrl+Enter) when making a new one. A view needs a name.
A view's tab with changes not yet saved carries a dot. The panel saves or reverts them.
In the panel, a view has:
- a name and an icon;
- Visible to: Only me, or Everyone;
- Project tab: show the view as a tab in the projects its Project filter names. It needs a Project filter with "is";
- In my favorites: pin it in your sidebar.
Who can change a view
You can change and delete your own views. A shared view can also be changed by workspace admins. Only its owner can make a shared view private again.
Project tabs
A view with Project tab on shows as a tab in every project its Project filter names, after All issues. In that tab it shows only that project's issues. The tab order is shared by everyone.
1opens All issues,2to9the tabs after it.⌥←and⌥→(Alt+←,Alt+→) move the open tab.
The view's menu
A view's ⋯ menu, on its tab, its page and the Views page, has:
- Edit view (
E) - Duplicate
- Move left, Move right
- Add to favorites, Remove from favorites
- Share with everyone in the workspace, or Make it only mine
- Copy link
- Delete view
Copy link gives an address that opens the view as a tab in the project, or on its own page.
The Views page
G then V opens the Views page: every view you can see. All, Shared and Only me narrow the list. Each row shows the view's projects ("All projects" when it names none), what else it filters, who sees it, its Tab and Favorite switches and its issue count.
A view's own page shows its issues across all its projects. The key on each row names the project.
In the terminal
rsva views lists the saved views you can see, shared and your own. rsva issues --view NAME lists a view's issues, and words after it narrow the list:
rsva views
rsva issues --view "Waiting for review" '#INFRA'See rsva.
My work
My work (G then M) is a built-in list of your issues from every workspace, in six groups: Waiting on you, You’re doing, Agents on your behalf, Up next, Later, Done this week.
Flimits it to one workspace or project;0shows All workspaces again.1to9jump to a section;⇧Dshows or hides Done this week.- Group by in the header lays the same issues out by section, status, priority or project.
- A group folds and unfolds by its header; what is folded is kept on your account.