Lookup Lists
On this page
A lookup list holds the values offered for a field, such as statuses, types, or categories. There are three kinds of list:
- A class list belongs to one object class: every value belongs to that class. Statuses, types, and categories are class lists.
- A standalone reference list is one flat list shared by the whole installation, such as brands, budgets, or units of measure.
- The value list of a user-defined field belongs to that one field.
A reference field is not a lookup list: it points to another object.
The set of lookup kinds is fixed. You add values to a kind, never a new kind, and which lists each class has is built into the product. You maintain the lists in the Settings App; for the Settings App, see Admin Center and Settings App. For the Admin Center, see Classification.
In the Settings App
Open a class's lookup lists
In the Workflow and Business Logic tree, each class has a Classification node next to its Fields node. The page lists the lookup kinds of that class. Every class has the node except Software Catalog and the All Tickets/My Tickets and All Configuration Items nodes.
On Incidents, Problems, Change Requests, Work Orders, and Service Requests, the Urgencies, Impacts, and Priorities lists sit in a Priority Calculation folder; see Priority Calculation.
Some lists serve several classes. Medium Codes opened on a ticket class shows "This classifier is shared by Incidents, Change Requests, Problems, Service Requests, and Work Orders. Changes here affect all of them." Units of Measure opened on Consumables, Purchase Order Items, or Product Catalog shows the same notice for Consumables, PO Items, and Products (Product Catalog).
Software Platforms is not under any class.
Add or edit a value
- Click New or press Ins. A window for the new value opens.
- Enter the value. OK stays disabled while the value is blank.
- Set the options the kind shows:
- Active, checked on a new value.
- Available in the Self Service Portal, on Incident categories, checked on a new category.
- Icon:, on Statuses and Priorities, with Change..., Clear, Copy, and Paste.
- Tags, on the kinds that support tags, with Manage.
- Read Only, on Activity Categories. A new activity category starts with it selected.
- Click OK.
A new value of a list gets the next position, so it appears last.
To change a value, select it and click Edit, double-click it, or press Enter. The value's window opens.
Some kinds have options of their own:
- Statuses: the stage list offers only the lifecycle stages of the status's own class; see Lifecycle stages.
- Request Fulfillments: Service Request Create Action: picks one of the create actions of the Service Request workflow; the list offers every create action, enabled or not. Click the label to open that action's editor.
- Licensing Policy: a new policy tracks by device. You cannot change the tracking of a policy that software licenses already use with allocations it would exclude: switching to tracking by user is refused while a computer or hardware item is allocated, and switching to another tracking type is refused while a person is allocated. Allocations of records in their inactive status do not count. The refusal says that the selected tracking requires allocation to users or to devices and asks you to delete the existing allocations first.
- Stock Movement Reason: the kind is under Stock Rooms. The window of a new stock movement reason has a direction list with Out, In, and Transfer; a value saved with no direction is saved as Out.
Work with tags
You enter each tag of a value in the Add Tag or Edit Tag dialog. The dialog suggests the tags of the list you have open, plus any tag typed since you opened it.
Remove Keyword and Rename Keyword remove or rename a tag on the selected values only, not on every value of the list that carries the tag. With more than one value selected, the result reads "<n> of <m> records have been affected."
Order values
- In a list, Move Up and Move Down swap the value with its neighbor.
- Sort by Name, in lists and trees, asks "Are you sure you want to sort the <kind> items by name? This will reset the existing order." It is disabled while the list is filtered.
In the Categories and Activity Categories trees:
- New adds a category after the selected category's branch, and New Subcategory adds a child of the selected category.
- Move Up and Move Down (Ctrl+Up and Ctrl+Down) move the category one row through the displayed tree. Move Up makes it the last child of the sibling above, or, when it is its parent's first child, puts it before the parent. Move Down makes it the first child of the sibling below, or, when it is the last child, puts it after its parent.
- Move to... offers Category, which opens the Choose Category picker, and Top Level.
- Dragging a category onto another makes it that category's child. A category cannot be dragged onto itself or onto one of its subcategories.
- In the Choose Category picker, choosing the category itself or one of its subcategories as the new parent is refused: "You cannot move an item into itself or into one of its sub-items."
- Expand All and Collapse All open and close the whole tree.
In a tree, Ins adds a category, Delete deletes, Enter edits, and Ctrl+A selects all. In a list, Ins, Delete, and Enter add, delete, and edit a value.
Retire or reactivate values
On the kinds that support Active, Activate and Deactivate change the selected values only; on Personal Event Categories the commands read Enable and Disable. When you deactivate a parent category, its subcategories keep their own state.
A deactivated value is left out of the lists that offer active values only. Where inactive values must still be shown, they are.
On the Incident Categories tree, Mark as Internal and Mark as Public set whether the selected categories are available in the Self Service Portal. With one category selected, one of the two commands is enabled at a time.
System values and customer values
A system value cannot be deleted, but you can rename it, move it, retire it, and tag it. Whether a value is a system value cannot be changed. The value lists of user-defined fields are not subject to this protection. A value that is not a system value can be deleted unless records still refer to it; see Delete values.
Every new database contains 81 values that the product itself supplies, among them statuses, relationship types, licensing policies, depreciation methods, genders, software platforms, e-mail types, personal event categories, and one workspace, IT. Every one of them in a list that carries the system flag is a system value and cannot be deleted; the IT workspace is one of them.
A new 2026.1 database created with the Default Workflow also contains a much larger set of values, among them categories, types, statuses, closure codes, relationship types, and lifecycle stages; see Default Workflow Configuration. These values are configuration content, not values the product supplies. An upgraded database need not contain them, and an administrator may have changed them. The stock movement reasons of the supplied configuration, for example, are not system values: they can be renamed and deleted.
Delete values
Select one or more values and click Delete or press Del.
- The question reads "Are you sure you want to delete the selected <class> <item>?" or "Are you sure you want to delete <n> selected items?".
- A single system value is refused before the question: "This is a system record and it cannot be deleted."
- A value that records still refer to is refused: "Unable to delete item because it is referenced by other database object(s). To delete the item, you need to remove these dependencies first.", followed by the server's reply. While other selected values remain, "Would you like to continue removing the remaining records?" offers Yes, Yes to All, and No.
- A workspace that a role or an object uses is refused. For an object, the message reads "Cannot delete the Workspace because it is associated with one or more objects."
- When several values of a list are deleted, system values among them are skipped. "<n> of <m> items have been deleted." appears when every selected value went. When some did not and none of them was a system value, no message appears.
- In a Categories tree, the deepest selected levels are deleted first, a refusal shows the server's text alone, and a delete of several categories always ends with the "<n> of <m>" count.
Copy a value's ID
The pop-up menus of the list and of the tree offer Copy Item ID (GUID) to Clipboard, enabled when one value is selected. Ctrl+Alt+C copies the ID of the focused value. You can search the workflow for the ID with Search in Workflow.
Lifecycle stages
Lifecycle stages exist for Incidents, Problems, Change Requests, Work Orders, Service Requests, and Purchase Orders.
- A stage's window has a Name: box and a read-only Statuses box that lists every active status that names the stage, one per line. A stage has no tags.
- Move Up and Move Down set the order of the stages.
- In a status's window, the stage list offers only the stages of the status's own class. A status names one stage, and a stage may hold several statuses.
In the Web App
Brands, a standalone reference list, have their own Brands navigation item in the Web App; see Company Addresses and Brands.
The lifecycle stage bar
At the top of a ticket or purchase order form, the Web App shows the class's lifecycle stages in their order. The current stage is the stage that the record's status names, and it is highlighted. The stage changes only when the status changes; nothing sets a stage on the record directly. A class with no stages shows no bar, and a status that names no stage marks no stage as current. For tickets, see Tickets.
Lookup kinds
"Per class" means that each class has its own list of that kind. The other kinds are single lists for the whole installation.
| Kind | Per class | Options of a value |
|---|---|---|
| Categories | Yes | Active, tags; on Incident categories, availability in the Self Service Portal. A tree of categories and subcategories. |
| Statuses | Yes | Active, tags, icon, lifecycle stage |
| Types | Yes | Active, tags |
| Activity Categories | Yes | Active, tags, read-only. A tree of categories and subcategories. |
| Workspaces | No | Active, tags |
| Medium Codes | No | Active, tags |
| Closure Codes | Yes | Active, tags |
| Urgencies | Yes | Active, tags |
| Impacts | Yes | Active, tags |
| Priorities | Yes | Active, tags, icon |
| Request Fulfillments | No | Active, create action |
| Software Platforms | No | Tags |
| Licensing Policy | No | Tags, tracking |
| Genders | No | - |
| Personal Titles | No | Tags |
| E-mail Types | No | Tags |
| Personal Event Categories | No | Active |
| Budget Categories | No | Tags |
| Payment Terms | No | Tags |
| Shipping Codes | No | Tags |
| Freight Terms | No | Active, tags |
| Depreciation Methods | No | Tags |
| Relationship Types | No | - |
| Units of Measure | No | Active, tags |
| Threshold Actions | No | Active, tags |
| Stock Movement Reason | No | Active, tags, direction |
| Lifecycle Stages | Yes | - |
| Completion Timing | No | Tags |
An active value can be retired without being deleted. Tags are free keywords for filtering.