Tags
On this page
Tags come from one global tag catalog, and you attach them to records. Tags add a classification on top of types and categories: a record's type and its category each hold one value, but a record can carry any number of tags. The catalog is shared by all record classes, and a tag has no class, group, or category of its own, so tags form groups only through the names you give them, for example tags for departments, projects, VIP customers, or records that need review.
Tags appear as a field on a record's form, as a cell in a list, as a list filter, and as a search criterion. Banners are notices an administrator authors; you dismiss them for yourself.
The tag catalog itself is managed in the Admin Center; see Tag Management.
Tags in the Web App
What you can see and change
If you may edit a record, you can attach catalog tags to it and remove them, unless the Tags field is read-only. Attaching a tag needs no permission of its own.
Creating a new tag needs the Add New Tags permission. Without it, you can still pick existing tags, but the Create tag button is disabled, and its tooltip tells you that you do not have enough permissions.
Add or remove tags on a record
- Open the record and click the Tags field.
- In the list that opens, type in the Filter tags box to narrow the tags, and select the check box of each tag you want. The filter ignores case, and the tags are listed alphabetically. When nothing matches, the list shows No tags found.
- Close the list by clicking outside it, by pressing Escape, or with the create button below it. The field takes the selected tags only when the list closes.
To remove a tag, point to its chip and click its delete control. This changes the field at once.
Create a tag while tagging a record
- Click the Tags field and type the name you want in the Filter tags box. Only letters,
digits, spaces, and the characters
/,_,:, and-can be typed. - Click the button under the list. When the last filter text that matched no tag has 3 or more characters, the button reads Create tag for followed by that text, and keeps it until you empty the filter box; otherwise it reads Create tag.
- In the popover that opens, review or edit the name in the Enter a new tag name box. When the button read Create tag for followed by text, the box holds that text; when it read Create tag, the box holds New Tag (with a number added when that name is taken). This box accepts the same characters as the Filter tags box.
- Pick a color swatch from the row below the name. Each of the 30 swatches is a background and text color pair. If you pick none, the tag gets the popover's default pair.
- Click the check icon to save the tag and add it to the field, or the cross to close the popover without creating the tag.
A tag name can be at most 50 characters long and must be unique. The popover refuses a blank name, a name already in use, and a name over 50 characters, each with an inline error.
Change tags on many records at once
- In a list, select the records to change.
- From the toolbar's Actions menu, choose Tags. The entry appears when the record class has a Tags column. With no records selected it is disabled and shows No records selected. On a list you may not edit, it answers You do not have enough permissions to use this function.
- In the Tags pane, which reads Choose how to modify tags for N selected records, choose Add new tags (selected by default), Replace existing tags with new ones, or Remove all existing tags.
- For Add new tags or Replace existing tags with new ones, choose the tags in the tag field. For Remove all existing tags, the tag field is disabled.
- Click Start. It stays disabled until you choose a tag or pick removal.
- Read the result and click Finish to close the pane.
The result is one of these messages:
- All N selected records have been updated.
- Only N out of M objects have been updated.
- None of the records have been updated.
The last two list the reasons: records that are read-only in a Closed, Retired, or Inactive status, records you have no permission to modify, and tags that were already applied. The list refreshes when the run ends.
For other changes to many records, see Update Several Records at Once.
Where tags appear
On the default form layouts, the Tags field is on the General tab:
- In the Categorization section on the Service Request, Problem, Change Request, Work Order, Announcement, Service, SLA, Asset, Contract, Library Item, Reservation, Stock Rule, Consumable, Purchase Order, Vendor, Product, Computer, Hardware, Network, Document, Configuration, Software License, Tracked Software, and Organization forms.
- In the Details section on the Incident, Approval Request, Knowledge Base Article, Service Catalog Item, Project, Task, PO Item, Location, Person, and Group forms.
A layout an administrator has changed may place the field elsewhere.
A tag used as a search term always matches tag text as a substring; it never uses the full-text index.
A tag chip shows the background and text color of its tag. A tag stored with no colors is shown in the default background with black text. A chip has a fixed maximum width, so a long tag name is clipped rather than widening the field or cell; only the preview chip in the tag creation popover is allowed to grow wider.
Banners
A banner is a notice an administrator authors with its content, an optional condition, a priority, and an optional expiration date.
A banner's priority sets its color: priority 0 is red, priority 2 is green, and priority 1 or any other value is yellow.
You can dismiss a banner in two ways:
- Don't show this again dismisses the banner for you. The dismissal is recorded on the server.
- The x button hides the banner for your current sign-in, for at most 14 days. The banner returns after you sign in again.
The active banners are read once each time a page loads. The banner area has a maximum height and scrolls when its content is taller. A tall banner collapses to one line with a chevron. Banners are not shown when the page is displayed inside a frame.
Related topics
- Tag Management - manage the tag catalog in the Admin Center.
- Update Several Records at Once - other changes to many records.