List Toolbar, Preview and Export
On this page
A list's toolbar holds the Actions, New, Export, and Options menus and the "Filter items (/)" box. Right-click menus, row flags, and the preview pane work on the rows of the same list. For lists and their views, see Lists and Views.
Which toolbar controls a list shows depends on where the list is; see Where the toolbar controls appear.
In the Web App
Create a record with New
Each time you open New, it fetches the class's create actions. While it does, the menu shows a disabled "Loading..." item; for a class with no create actions, it shows a disabled "No Actions" item. Create actions in a group appear as nested flyouts.
Select rows
When an ungrouped main list opens, its first row is shown in the preview but not selected. A picker, a related-objects grid, or a list opened with a focused row in its URL selects a row instead: the row the URL names, or else the first row. Any other grid inside a form starts with no row selected.
- Click a row to show it in the preview. Up Arrow and Down Arrow move the preview to another row and clear the checked rows; Left Arrow and Right Arrow expand or collapse a tree row. The keys do nothing while a text box or an editable element has the focus.
- Ctrl-click, Cmd-click, or Shift-click a row anywhere except its checkbox or a link to select it instead of previewing it. In a list that allows only one selected row, this selects only the clicked row.
- In a list that allows several selected rows, Ctrl-click or Cmd-click a checked row to uncheck it. On an unchecked row, it checks the row, makes it the start of a range, and also checks the row currently in the preview, if there is one.
- In such a list, Shift-click clears the selection and checks every row, except group rows, from the start of the range through the clicked row. With no range start yet, the previewed row, or else the clicked row, becomes the start. The range covers the rows of all pages, in the current filter and order.
- The header checkbox checks the selectable rows of the current page; in a tree, collapsed child rows are included. When the filtered rows run past one page, a bar then offers "Select all N records". Clicking the checkbox while everything in scope is checked clears the selection.
- Changing the page clears a selection that covers only the current page.
Search the loaded rows
The "Filter items (/)" box searches only the rows already loaded in your browser; it does not request data from the server. Press / to focus this box in the active list, unless the cursor is in an editable element.
- The box takes effect shortly after you stop typing. A row stays when the text of at least one searchable column, as the cell displays it, contains what you typed, ignoring case. Runs of spaces count as one space.
- For a Tags column, the tag names are searched. A number you type is also looked for in your number format, so "1000" finds "1,000".
- The selection and row-action columns are never searched. A column the view is grouped by is hidden and not searched, except the flag column, which stays shown.
- A field that is not a column of the view, because it was never added or is hidden, is not searched. Its text is found once the field is added to the view through Customize View.
- A change of the search text clears the row selection. A change of letter case, or of leading or trailing spaces only, does not.
- The Clear button, shown inside the box while it holds text, empties it.
Sort and group rows
- Click a sortable column heading to sort ascending, then descending, then not at all. Shift-click another heading to add a secondary sort. A click on a column sorted descending removes only that column's sort and keeps the grouping and the other sorts.
- Sort in the column and cell menus offers only ascending and descending. It replaces the view's sorts with that one column, unless the column is already the last sort; then only its direction changes and the earlier sorts stay.
- Once a column is grouped, the group-by box shows a chip for each grouped column, with its own sort, filter, and remove buttons, and, at its right, Expand All and Collapse All for the whole grid.
- Grouping orders the rows ahead of every header sort: rows are ordered by each grouped column first, by value or, once the group is set to sort by count, by group size. Header sorts order rows only within the groups.
- A new group starts ascending by value. While a column is grouped, its column heading is hidden, except for the flag column.
- The chip's order button switches the group between ascending and descending, and Sort in the grouped-row menu sets it by value or by count. Neither removes the group order. To remove it, ungroup the column: click the chip's remove button, drag the chip back onto the column headings, or click Ungroup.
A group header reads "<column>: <value> (Items: N)", where N is the number of rows in the group; the count is left out when the list hides counts. A group that continues at the top of the next page repeats its header with "(continued...)". An expanded last group whose rows are all on a later page shows the row "Items are located on the next page". Right-clicking a group header opens the grouped-row menu.
For the column, cell, and grouped-row menus, see Right-click menus. For the group-by box, see Display options.
Flag rows
Click a row's flag cell to open the same flag menu as Set Flag on the Actions menu. The menu lists Clear, Red, Blue, Yellow, Green, Orange, Purple, and Star, in that order, each with its own icon; a row with no flag shows Clear. Picking a flag changes the row at once, without opening the record.
Use the preview pane
The preview pane has three states:
- With one focused row, it shows the record's tags and a live preview of the record.
- With no focused row and more than one checked row, it shows "<N> items selected".
- Otherwise, it shows "Nothing is selected".
For a knowledge base article or an announcement, the preview shows its body; for a service catalog item, it shows the item's details.
The split between the list and the preview starts at 65/35. Once you drag it, your browser keeps the split for that list, so it does not travel with the view or follow you to another browser. Choosing Hide in Options (see Display options) forgets the split, moving the preview from the right to the bottom forgets it, and moving the preview to the right resets it to 65/35.
Export rows
- Click Export.
- Click Export all (CSV), Export all (Excel), Export selected (CSV), or Export selected (Excel). The "Export selected" choices are enabled only while rows are selected, and are not offered on a related-objects grid.
The file is built in your browser from the rows already loaded in the list, without a request to the server, so it holds no more rows than the list's record cap allows unless all rows were loaded. The file is named from the list title and the view name, joined by " - ". A repeated part is dropped, and characters that a file name cannot hold are replaced by "_".
- The CSV file is UTF-8 with a byte-order mark. Values are escaped with commas and quotes, and line breaks inside values are flattened.
- The Excel file has one worksheet with a bold, frozen header row. Numbers, dates, currency, and percentages are written as typed cells, and the view's highlighting rules are carried over as cell fills, borders, and fonts.
- In both formats, Tags are written as tag names joined by "; ".
- An "Export all" file has one line per group, the group summary lines when the view defines a group footer, and the grid's footer totals as the last line. An "Export selected" file has only the record rows.
For the Export and Delete buttons of an activity list, see The toolbar of an activity list.
Delete records
TIP: Delete a record only when you have a particular reason to. A deletion removes the record's history and its relationships to other records together with the record. Where the record's class has an action that retires the record or marks it inactive, end the record's lifecycle with that action instead: it changes the record's status and keeps its history and its relationships. For these actions, see Retire or mark inactive instead of deleting. In a database created with the supplied configuration, tickets (incidents, problems, change requests, service requests, and work orders) have no such action; a ticket's lifecycle ends when it is closed.
- Select the rows, click Actions, and click Delete. For one row, you can also click Delete in the row's action button.
- Confirm the deletion.
When the server answers that the records cannot be deleted, no confirmation is asked and the message "You do not have enough permissions to delete this item." appears.
When the deletion returns an error, the error message appears. When it returns other messages, they appear before the list refreshes.
The records are deleted one at a time. When a record is still referenced by other records, its deletion is refused with the message "Unable to delete/modify object because it is referenced by other database object(s). To delete/modify the object, you need to remove these dependencies first." The records after it in the selection are not deleted, and the list is not refreshed. After a successful deletion, the list refreshes; inside a form, the tab counters refresh too.
On the Recurrent Tickets list, the toolbar has its own Delete button, enabled by any selection. It asks for its own confirmation, then deletes the selected records, clears the selection, and refreshes the list.
For when Delete is disabled or not offered, see The Actions menu. For the row's action button, see Right-click menus. For what counts as a reference to a record and how to clear it, see What blocks a deletion.
Work with a tree list
When a page of a tree list begins below the top level, a bar in the first row lists the ancestors of that first row: the nearest one as plain text and the others as links. Clicking a link turns to the page that holds that ancestor. The tree/list toggle beside the link column is hidden on a related-objects grid. Grouping by any column shows the tree as a flat list, without the toggle or the ancestor bar, until the grouping is removed.
Reference
This section gives the details of the list toolbar and the grid in the Web App.
Where the toolbar controls appear
Which toolbar controls a list shows depends on where the list is:
- Actions and New show on a class's main list, its single-view variant, and Advanced Search. They never show on a related-objects grid inside a form.
- Export shows in the same three places. A related-objects grid keeps Export, but without its "Export selected" choices.
- A related-objects grid has no Options button and no Customize button.
The Actions menu
The Actions button is disabled while no row is selected, except on a grid inside a form that declares global actions. From top to bottom, the menu offers these entries where they apply:
- Unstar, on your "My Starred" list.
- Set Flag, when the view's fixed columns include the flag column. It opens the same flag menu as the flag cell.
- Tags, when the class has a Tags column.
- For a workflow class, an Actions flyout with the workflow actions available for the selected records. Actions in a named group appear in a further flyout.
- Batch Update, unless the list hides it.
- Show dependencies, on a main list. It is enabled when exactly one row is selected.
- Delete. It is disabled unless the server reports that the selection can be deleted, and it is not offered on a related-objects grid.
Set Flag and Tags are disabled with "No records selected" when nothing is selected. Tags answers "You do not have enough permissions to use this function." when the page does not allow editing, and Batch Update answers the same message when you do not have the right to use it.
On a grid inside a form that has unsaved changes, picking an action first asks you to save or discard the changes. For what a workflow action does once you pick it, see Perform Actions on Records.
Batch Update writes field values, chosen from a list of fields, to the selected records, or applies a tag change to them. A field update ends with a message that gives the number of records updated against the number selected. A tag change ends with one message when every record was updated and with another that gives both counts when only some were; when none was updated, it fails with an error.
Right-click menus
Right-clicking gives a different menu on a column heading, a group, and a row. None of them carries workflow actions or Delete.
- On a column heading: Group By, and, on a related-objects grid only, Sort.
- On a grouped row or its group chip: Expand, Collapse, Sort by value or by count, each ascending or descending, and Ungroup.
- On a data cell: Open, Open in new tab, and Open in current tab, following your preference for opening records in a new tab; Entity Details where allowed; an extra open item on Approval Requests only; Filter By and Filter Not By; Group By; Sort; and any items the page adds.
Each row also has an action button titled "Open" when the list allows actions, except in a picker and while a tree list is shown as a tree. It lists the open items of the right-click menu when the list allows opening, and then the Actions menu for that one row without Unstar, Set Flag, Tags, and Batch Update:
- the row's workflow actions, grouped, or "No Actions" while there are none;
- Show dependencies, on a main list;
- Delete, which depends on whether the server reports that the row can be deleted, and which is not offered on a related-objects grid.
Display options
The Options button holds display settings that belong to you, not to the list: a setting chosen on one list applies to the next list you open.
- Group by box turns on or off the box above the grid, which reads "Drag a column header here to group by that column" while nothing is grouped. It is on until you change it.
- Density is Comfort, Compact, or Condensed, and applies to data rows, group rows, the header, and the footer together, except that the footer of an embedded grid keeps the Condensed height whatever the density. Condensed is the tightest. The density is Comfort until you change it. A related-objects grid always renders at the condensed density.
- Preview, only on a main list or Advanced Search whose grid has a preview, places the preview pane: Show on the right, Show on the bottom, or Hide. The preview is shown until you change it.
What blocks a deletion
A record is referenced when a field of another record still points at it, for example a computer whose owner is the person you delete. Some fields are cleared by the deletion instead: deleting a person clears the manager field of the other persons who name that person as their manager. The refusal message quoted in Delete records does not name the referencing records. The deletion of a person is refused while the person has an account, and the deletion of an organization or a location while a person or a child record points at it. The record's relationships to other records, its attachment links, flags, tags, and history are removed with the record and never block its deletion. For what else the deletion of a person removes or keeps, see Organizations and Locations.
The deletion succeeds once every field that points at the record is cleared or pointed at another record, for example once each computer the person owns has a new owner, and the deletion is run again.
Retire or mark inactive instead of deleting
The refusal message of a deletion (see Delete records) names no alternative to the deletion. In a new 2026.1 database created with the supplied configuration (see Default Workflow Configuration), several record classes have a workflow action that retires the record or marks it inactive instead. It is in the General group of the workflow actions, on the same Actions menu and row action button as Delete, and it can run on several selected records at once. Whether it is offered depends on your security role and on the type and status of every selected record; see Why an action is missing or dimmed. For example:
- Retire Computer sets a computer's status to Retired. Unretire Computer, offered on a retired computer, reverses it.
- Mark Inactive sets a person's status to Inactive. Mark Active, offered on an inactive person, reverses it.
Besides Retire Computer, the retire actions are Retire Hardware, Retire Asset, Retire License, Retire Software, Retire Configuration, Retire Contract, Retire Document, Retire Article, Retire Consumable, and Retire Library Item.
Neither Retire Computer nor Mark Inactive clears the records that reference the record, so neither is refused as the deletion was. A retire or mark-inactive action changes the record's status and removes neither its history nor its relationships to other records. A person at the Inactive status cannot sign in. Mark Inactive also deactivates every account of the person, technician accounts included, and Mark Active makes every account of the person active. A database upgraded from an earlier version need not have these actions, and an administrator may have changed them.
A retired computer no longer counts as a use of a software license, and neither does an allocation to an inactive person under a policy that tracks usage by user; see License Compliance. AlloyScan synchronization leaves a retired computer unchanged; see AlloyScan Synchronization. Alloy Discovery synchronization, when it is set to delete retired devices, deletes a retired computer's record in the Alloy Discovery database and removes the computer's link to it; see Alloy Discovery Synchronization. An administrator's archiving job can later remove closed tickets that have not been modified for a set period, with or without copying them to an archive database; see Data Archiving. The archiving job handles only tickets: it never archives or removes a retired or inactive record of another class. An archive copy of a ticket keeps its activity log and attachments, but not its history or its relationships to other records. Archiving is not available in Alloy Navigator Cloud or on a database hosted in Azure SQL.
Read the cells
Cells with several values and Tags cells that do not fit show a "…" button that lists all the values. The values are sorted alphabetically, and the values of a multi-select field are shown in lower case. Tags cannot be edited in the grid.
- A Yes/No cell shows a check mark for Yes and nothing for No or an empty value.
- A memo cell shows its full text in a tooltip, however much of it the cell shows.
- A rating shows five stars filled in proportion, and nothing for zero or no rating.
- A picture loads once its row scrolls into view. At the Condensed density, pictures are not shown, but the text beside them is.
- A person cell shows the person's photo, except at the Condensed density, and the name, which is a link that opens the person's details unless the row marks the name as plain text.
A link cell opens the record when you click it; inside a picker or a related-objects grid, the click returns the row to the caller and closes the picker or grid. In a row whose type is Link, the cell is a plain link to the row's value. A middle-click always opens a new tab. In a list that does not allow opening records, the cell shows plain text. Most link cells have a copy button, shown when you point to the cell, that copies both the record's link and an HTML link labeled with the cell's text; on the Web Reports list, it copies a link to the report instead. The "Copy link to clipboard" button of the row's own record sits in the link column, so a view that hides that column does not show it.
The toolbar of an activity list
An activity list shows the same Export button as other lists (see Export rows), disabled when you do not have the right to export the view. Its toolbar also has a Delete button: one read-only activity in the selection disables it for the whole selection, with its own hint, and otherwise it first asks the server whether the activities can be deleted. On an activity list of a class other than Incident, Service Request, Work Order, and Reservation, the toolbar removes the Published column from the view, even when a saved view lists it. See Activity Log.
Related topics
- Perform Actions on Records - what a workflow action does once you pick it from the Actions menu.
- Lists and Views - lists and their views.