Permissions Reference
On this page
- Object permission shapes
- Object permissions in the role editor
- Service Desk permissions
- Service Management permissions
- Project Management permissions
- Asset Management permissions
- Purchasing permissions
- Configuration Management permissions
- Software Asset Management permissions
- Organization Management permissions
- Miscellaneous permissions
- Permissions with special rules
- Activity permissions
- Approval permissions
- Cross-cutting permission groups
- Administrative permissions
- Permissions and the license
- Effective permissions in the Settings App
- Related topics
A security role can carry two kinds of permissions. Object permissions decide what a user may do to business records. Administrative permissions decide which section of the Settings App or the Admin Center a user may open. See Security Roles for roles themselves.
Object permission shapes
Which shape a class gets is a property of the class, not a setting.
| Shape | Permissions | Classes |
|---|---|---|
| Flat | Delete, Modify, and View, each a single grant | Contract, Purchase Order, SLA, Service, Location, Organization, Group, Person, Project, Vendor, Product, Stock Rule, Service Catalog Item, Equipment Lending Library, Equipment Reservation, Approval Stage, Approval Request, Report |
| Owner-scoped | Delete, plus Modify Permissions and View Permissions, each holding an any-record permission and an owner-only permission | Computer, Hardware, Tracked Software, Software License, Network, Document, Asset, Configuration, Consumable |
| Ticket-scoped | Delete, plus Modify Permissions and View Permissions, each holding permissions for any record, for records within your group, for records you are assigned to, and for records you requested | Incident, Problem, Change Request, Work Order, Service Request |
| Assignee-scoped | Delete, plus Modify Permissions and View Permissions, each holding a permission for any record and a permission for records you are assigned to; no permission for records within your group or for records you requested | Project Task |
In the Settings App's role editor, Modify Permissions and View Permissions are parent nodes: ticking one ticks the permissions under it, and saving the role stores only those permissions, never the parent node.
Object classes have no separate Create permission, except Report: creating a record outside a workflow action follows the Modify permission. The Component class is hidden from the role editor.
What a class's View permission shows in the Web App's navigation is described in Security Roles.
Object permissions in the role editor
The Settings App's role editor shows the permissions as a tree under ten bold top nodes, in this order: Management and Administration, Service Desk, Service Management, Project Management, Asset Management, Purchasing, Configuration Management, Software Asset Management, Organization Management, and Miscellaneous. Management and Administration holds the cross-cutting permission groups and, under Administrative Access, the administrative permissions. The other top nodes hold one group per object class, and Miscellaneous also holds the groups Customer Satisfaction Rating and Reference Tables. The license decides which groups are shown; see Permissions and the license. How to tick permissions in the tree is described in Security Roles.
The sections below follow the tree: one section per top node and one table per group, with the permissions in the order the tree shows them. Each permission has the name and the description the Settings App's role editor shows. Under names the node a permission sits under when it is not directly under its group.
The Admin Center's role editor, on a role's Permissions tab, shows the same top nodes and groups, with the same names and in the same order. It does not list Invoice Management, the business-logic right Invoices, or Dashboard Widgets; only the Settings App's role editor offers these three, Dashboard Widgets only while the database contains a legacy dashboard widget. Saving a role in the Admin Center replaces all of the role's permissions with the ones ticked on its Permissions tab, so a role that held any of these three permissions no longer holds it after it is saved there.
Service Desk permissions
Incident
| Permission | Under | Description |
|---|---|---|
| Delete | - | Allows deleting Incidents |
| Modify Permissions | - | Scope-specific permissions to modify Incidents |
| Modify | Modify Permissions | Allows modifying any Incident |
| Modify within group | Modify Permissions | Allows modifying Incidents where the user is a member of Assignee Group |
| Modify if Assignee | Modify Permissions | Allows modifying Incidents for which the user is the assignee |
| Modify if Requester | Modify Permissions | Allows modifying Incidents for which the user is the requester |
| View Permissions | - | Scope-specific permissions to browse and view Incidents |
| View | View Permissions | Allows browsing and viewing any Incident |
| View within group | View Permissions | Allows browsing and viewing Incidents where the user is a member of Assignee Group |
| View if Assignee | View Permissions | Allows browsing and viewing Incidents for which the user is the assignee |
| View if Requester | View Permissions | Allows browsing and viewing Incidents for which the user is the requester |
| Manage Activities | - | Allows modifying, and deleting Incident Activities |
Service Request
| Permission | Under | Description |
|---|---|---|
| Delete | - | Allows deleting Service Requests |
| Modify Permissions | - | Scope-specific permissions to modify Service Requests |
| Modify | Modify Permissions | Allows modifying any Service Request |
| Modify within group | Modify Permissions | Allows modifying Service Requests where the user is a member of Assignee Group |
| Modify if Assignee | Modify Permissions | Allows modifying Service Requests for which the user is the assignee |
| Modify if Requester | Modify Permissions | Allows modifying Service Requests for which the user is the requester |
| View Permissions | - | Scope-specific permissions to browse and view Service Requests |
| View | View Permissions | Allows browsing and viewing any Service Request |
| View within group | View Permissions | Allows browsing and viewing Service Requests where the user is a member of Assignee Group |
| View if Assignee | View Permissions | Allows browsing and viewing Service Requests for which the user is the assignee |
| View if Requester | View Permissions | Allows browsing and viewing Service Requests for which the user is the requester |
| Manage Activities | - | Allows modifying, and deleting Service Request Activities |
Problem
| Permission | Under | Description |
|---|---|---|
| Delete | - | Allows deleting Problems |
| Modify Permissions | - | Scope-specific permissions to modify Problems |
| Modify | Modify Permissions | Allows modifying any Problem |
| Modify within group | Modify Permissions | Allows modifying Problems where the user is a member of Assignee Group |
| Modify if Assignee | Modify Permissions | Allows modifying Problems for which the user is the assignee |
| Modify if Requester | Modify Permissions | Allows modifying Problems for which the user is the requester |
| View Permissions | - | Scope-specific permissions to browse and view Problems |
| View | View Permissions | Allows browsing and viewing any Problem |
| View within group | View Permissions | Allows browsing and viewing Problems where the user is a member of Assignee Group |
| View if Assignee | View Permissions | Allows browsing and viewing Problems for which the user is the assignee |
| View if Requester | View Permissions | Allows browsing and viewing Problems for which the user is the requester |
| Manage Activities | - | Allows modifying, and deleting Problem Activities |
Change Request
| Permission | Under | Description |
|---|---|---|
| Delete | - | Allows deleting Change Requests |
| Modify Permissions | - | Scope-specific permissions to modify Change Requests |
| Modify | Modify Permissions | Allows modifying any Change Request |
| Modify within group | Modify Permissions | Allows modifying Change Requests where the user is a member of Assignee Group |
| Modify if Assignee | Modify Permissions | Allows modifying Change Requests for which the user is the assignee |
| Modify if Requester | Modify Permissions | Allows modifying Change Requests for which the user is the requester |
| View Permissions | - | Scope-specific permissions to browse and view Change Requests |
| View | View Permissions | Allows browsing and viewing any Change Request |
| View within group | View Permissions | Allows browsing and viewing Change Requests where the user is a member of Assignee Group |
| View if Assignee | View Permissions | Allows browsing and viewing Change Requests for which the user is the assignee |
| View if Requester | View Permissions | Allows browsing and viewing Change Requests for which the user is the requester |
| Manage Activities | - | Allows modifying, and deleting Change Request Activities |
Work Order
| Permission | Under | Description |
|---|---|---|
| Delete | - | Allows deleting Work Orders |
| Modify Permissions | - | Scope-specific permissions to modify Work Orders |
| Modify | Modify Permissions | Allows modifying any Work Order |
| Modify within group | Modify Permissions | Allows modifying Work Orders where the user is a member of Assignee Group |
| Modify if Assignee | Modify Permissions | Allows modifying Work Orders for which the user is the assignee |
| Modify if Requester | Modify Permissions | Allows modifying Work Orders for which the user is the requester |
| View Permissions | - | Scope-specific permissions to browse and view Work Orders |
| View | View Permissions | Allows browsing and viewing any Work Order |
| View within group | View Permissions | Allows browsing and viewing Work Orders where the user is a member of Assignee Group |
| View if Assignee | View Permissions | Allows browsing and viewing Work Orders for which the user is the assignee |
| View if Requester | View Permissions | Allows browsing and viewing Work Orders for which the user is the requester |
| Manage Activities | - | Allows modifying, and deleting Work Order Activities |
Approval Stage
| Permission | Description |
|---|---|
| Delete | Allows deleting Approval Stages |
| Modify | Allows modifying Approval Stages |
| View | Allows browsing and viewing Approval Stages |
| Manage Activities | Allows modifying, and deleting Approval Stage Activities |
Approval Request
| Permission | Description |
|---|---|
| Delete | Allows deleting Approval Requests |
| Modify | Allows modifying Approval Requests |
| View | Allows browsing and viewing Approval Requests |
Approval stages and approval requests also check the object being approved; see Approval permissions.
Knowledge Base
| Permission | Description |
|---|---|
| Delete | Allows deleting articles from the Knowledge Base |
| Modify | Allows modifying Knowledge Base Articles and categories |
| View | Allows browsing and viewing Knowledge Base Articles in Live status |
| View All Articles | Allows browsing and viewing any Knowledge Base Articles |
| Manage Activities | Allows modifying, and deleting Knowledge Base Article Activities |
Which articles View and View All Articles admit is described under Permissions with special rules.
Announcement
| Permission | Description |
|---|---|
| Announcement Management | Allows managing Announcements |
| Manage Activities | Allows modifying, and deleting Announcement Activities |
Listing announcements follows rules of its own; see Permissions with special rules.
Service Management permissions
Service Catalog Item
| Permission | Description |
|---|---|
| Delete | Allows deleting Service Catalog Items |
| Modify | Allows modifying Service Catalog Items and categories |
| View | Allows browsing and viewing Service Catalog Items |
| Manage Activities | Allows modifying, and deleting Service Catalog Item Activities |
Service
| Permission | Description |
|---|---|
| Delete | Allows deleting Services |
| Modify | Allows modifying Services |
| View | Allows browsing and viewing Services |
| Manage Activities | Allows modifying, and deleting Service Activities |
SLA
| Permission | Description |
|---|---|
| Delete | Allows deleting SLA records |
| Modify | Allows modifying SLA records |
| View | Allows browsing and viewing SLA records |
| Manage Activities | Allows modifying, and deleting SLA record Activities |
Project Management permissions
Project
| Permission | Description |
|---|---|
| Delete | Allows deleting Projects |
| Modify | Allows modifying Projects |
| View | Allows browsing and viewing Projects |
| Manage Activities | Allows modifying, and deleting Project Activities |
Project Task
| Permission | Under | Description |
|---|---|---|
| Delete | - | Allows deleting Project Tasks |
| Modify Permissions | - | Scope-specific permissions to modify Project Tasks |
| Modify | Modify Permissions | Allows modifying any Project Task |
| Modify if Assignee | Modify Permissions | Allows modifying Project Tasks for which the user is the assignee |
| View Permissions | - | Scope-specific permissions to browse and view Project Tasks |
| View | View Permissions | Allows browsing and viewing any Project Task |
| View if Assignee | View Permissions | Allows browsing and viewing Project Tasks for which the user is the assignee |
| Manage Activities | - | Allows modifying, and deleting Project Task Activities |
Asset Management permissions
Asset
| Permission | Under | Description |
|---|---|---|
| Delete | - | Allows deleting Assets |
| Modify Permissions | - | Scope-specific permissions to modify Assets |
| Modify | Modify Permissions | Allows modifying any Asset |
| Modify if Owner | Modify Permissions | Allows modifying Assets for which the user is the owner |
| View Permissions | - | Scope-specific permissions to browse and view Assets |
| View | View Permissions | Allows browsing and viewing any Asset |
| View if Owner | View Permissions | Allows browsing and viewing Assets for which the user is the owner |
| Manage Activities | - | Allows modifying, and deleting Asset Activities |
Contract
| Permission | Description |
|---|---|
| Delete | Allows deleting Contracts |
| Modify | Allows modifying Contracts |
| View | Allows browsing and viewing Contracts |
| Manage Activities | Allows modifying, and deleting Contract Activities |
Equipment Lending Library
| Permission | Description |
|---|---|
| Delete | Allows deleting Library Items |
| Modify | Allows modifying Library Items |
| View | Allows browsing and viewing Library Items |
| Manage Activities | Allows modifying, and deleting Library Item Activities |
Equipment Reservation
| Permission | Description |
|---|---|
| Delete | Allows deleting Equipment Reservations |
| Modify | Allows modifying Equipment Reservations |
| View | Allows browsing and viewing Equipment Reservations |
| Manage Activities | Allows modifying, and deleting Equipment Reservation Activities |
Stock Rule
| Permission | Description |
|---|---|
| Delete | Allows deleting Stock Rules |
| Modify | Allows modifying Stock Rules |
| View | Allows browsing and viewing Stock Rules |
| Manage Activities | Allows modifying, and deleting Stock Rule Activities |
Stock Room
| Permission | Description |
|---|---|
| Stock Room Management | Allows adding, modifying, and deleting Stock Rooms |
Stock Room Management is the only permission for stock rooms; see Permissions with special rules.
Consumable
| Permission | Under | Description |
|---|---|---|
| Delete | - | Allows deleting Consumables |
| Modify Permissions | - | Scope-specific permissions to modify Consumables |
| Modify | Modify Permissions | Allows modifying any Consumable |
| Modify if Owner | Modify Permissions | Allows modifying Consumables for which the user is the owner |
| View Permissions | - | Scope-specific permissions to browse and view Consumables |
| View | View Permissions | Allows browsing and viewing any Consumable |
| View if Owner | View Permissions | Allows browsing and viewing Consumables for which the user is the owner |
| Manage Activities | - | Allows modifying, and deleting Consumable Activities |
Purchasing permissions
Purchase Order
| Permission | Description |
|---|---|
| Delete | Allows deleting Purchase Orders |
| Modify | Allows modifying Purchase Orders |
| View | Allows browsing and viewing Purchase Orders |
| Manage Activities | Allows modifying, and deleting Purchase Order Activities |
| Invoice Management | Allows adding, modifying, and deleting Invoices |
Invoices have no group of their own: Invoice Management covers them; see Permissions with special rules.
Vendor
| Permission | Description |
|---|---|
| Delete | Allows deleting Vendors |
| Modify | Allows modifying Vendors |
| View | Allows browsing and viewing Vendors |
| Manage Activities | Allows modifying, and deleting Vendor Activities |
Product
| Permission | Description |
|---|---|
| Delete | Allows deleting Products |
| Modify | Allows modifying Products |
| View | Allows browsing and viewing Products |
| Manage Activities | Allows modifying, and deleting Product Activities |
Vendor products have no permissions of their own and follow these; see Permissions with special rules.
Configuration Management permissions
Computer
| Permission | Under | Description |
|---|---|---|
| Delete | - | Allows deleting Computers |
| Modify Permissions | - | Scope-specific permissions to modify Computers |
| Modify | Modify Permissions | Allows modifying any Computer |
| Modify if Owner | Modify Permissions | Allows modifying Computers for which the user is the owner |
| View Permissions | - | Scope-specific permissions to browse and view Computers |
| View | View Permissions | Allows browsing and viewing any Computer |
| View if Owner | View Permissions | Allows browsing and viewing Computers for which the user is the owner |
| Manage Activities | - | Allows modifying, and deleting Computer Activities |
Hardware
| Permission | Under | Description |
|---|---|---|
| Delete | - | Allows deleting Hardware records |
| Modify Permissions | - | Scope-specific permissions to modify Hardware records |
| Modify | Modify Permissions | Allows modifying any Hardware record |
| Modify if Owner | Modify Permissions | Allows modifying Hardware records for which the user is the owner |
| View Permissions | - | Scope-specific permissions to browse and view Hardware records |
| View | View Permissions | Allows browsing and viewing any Hardware record |
| View if Owner | View Permissions | Allows browsing and viewing Hardware records for which the user is the owner |
| Manage Activities | - | Allows modifying, and deleting Hardware record Activities |
Network
| Permission | Under | Description |
|---|---|---|
| Delete | - | Allows deleting Networks |
| Modify Permissions | - | Scope-specific permissions to modify Networks |
| Modify | Modify Permissions | Allows modifying any Network |
| Modify if Owner | Modify Permissions | Allows modifying Networks for which the user is the owner |
| View Permissions | - | Scope-specific permissions to browse and view Networks |
| View | View Permissions | Allows browsing and viewing any Network |
| View if Owner | View Permissions | Allows browsing and viewing Networks for which the user is the owner |
| Manage Activities | - | Allows modifying, and deleting Network Activities |
Document
| Permission | Under | Description |
|---|---|---|
| Delete | - | Allows deleting Documents |
| Modify Permissions | - | Scope-specific permissions to modify Documents |
| Modify | Modify Permissions | Allows modifying any Document |
| Modify if Owner | Modify Permissions | Allows modifying Documents for which the user is the owner |
| View Permissions | - | Scope-specific permissions to browse and view Documents |
| View | View Permissions | Allows browsing and viewing any Document |
| View if Owner | View Permissions | Allows browsing and viewing Documents for which the user is the owner |
| Manage Activities | - | Allows modifying, and deleting Document Activities |
Configuration
| Permission | Under | Description |
|---|---|---|
| Delete | - | Allows deleting Configurations |
| Modify Permissions | - | Scope-specific permissions to modify Configurations |
| Modify | Modify Permissions | Allows modifying any Configuration |
| Modify if Owner | Modify Permissions | Allows modifying Configurations for which the user is the owner |
| View Permissions | - | Scope-specific permissions to browse and view Configurations |
| View | View Permissions | Allows browsing and viewing any Configuration |
| View if Owner | View Permissions | Allows browsing and viewing Configurations for which the user is the owner |
| Manage Activities | - | Allows modifying, and deleting Configuration Activities |
Software Asset Management permissions
Software License
| Permission | Under | Description |
|---|---|---|
| Delete | - | Allows deleting Software Licenses |
| Modify Permissions | - | Scope-specific permissions to modify Software Licenses |
| Modify | Modify Permissions | Allows modifying any Software License |
| Modify if Owner | Modify Permissions | Allows modifying Software Licenses for which the user is the owner |
| View Permissions | - | Scope-specific permissions to browse and view Software Licenses |
| View | View Permissions | Allows browsing and viewing any Software License |
| View if Owner | View Permissions | Allows browsing and viewing Software Licenses for which the user is the owner |
| Manage Activities | - | Allows modifying, and deleting Software License Activities |
Tracked Software
| Permission | Under | Description |
|---|---|---|
| Delete | - | Allows deleting Tracked Software records |
| Modify Permissions | - | Scope-specific permissions to modify Tracked Software records |
| Modify | Modify Permissions | Allows modifying any Tracked Software record |
| Modify if Owner | Modify Permissions | Allows modifying Tracked Software records for which the user is the owner |
| View Permissions | - | Scope-specific permissions to browse and view Tracked Software records |
| View | View Permissions | Allows browsing and viewing any Tracked Software record |
| View if Owner | View Permissions | Allows browsing and viewing Tracked Software records for which the user is the owner |
| Manage Activities | - | Allows modifying, and deleting Tracked Software record Activities |
Organization Management permissions
Organization
| Permission | Description |
|---|---|
| Delete | Allows deleting Organizations |
| Modify | Allows modifying Organizations |
| View | Allows browsing and viewing Organizations |
| Manage Activities | Allows modifying, and deleting Organization Activities |
Location
| Permission | Description |
|---|---|
| Delete | Allows deleting Locations |
| Modify | Allows modifying Locations |
| View | Allows browsing and viewing Locations |
| Manage Activities | Allows modifying, and deleting Location Activities |
Person
| Permission | Description |
|---|---|
| Delete | Allows deleting Persons |
| Modify | Allows modifying Persons |
| View | Allows browsing and viewing Persons |
| Modify Own Work Time | Allows modifying the technician's own work time |
| Modify Work Time for All | Allows modifying personal work time for all technicians |
| Manage Activities | Allows modifying, and deleting Person Activities |
Group
| Permission | Description |
|---|---|
| Delete | Allows deleting Groups |
| Modify | Allows modifying Groups |
| View | Allows browsing and viewing Groups |
| Manage Activities | Allows modifying, and deleting Group Activities |
Miscellaneous permissions
Report
| Permission | Description |
|---|---|
| Create | Allows creating reports |
| Delete | Allows deleting reports |
| Modify | Allows modifying reports and categories |
| View | Allows running reports |
Which reports View then lists is described under Permissions with special rules.
Customer Satisfaction Rating
| Permission | Description |
|---|---|
| View All Ratings | Allows browsing and viewing ratings of all tickets |
| View Own Ratings | Allows browsing and viewing ratings of tickets for which the user is the assignee |
The incident list and the service request list show the requester's rating only when you hold View All Ratings, or hold View Own Ratings and are the ticket's assignee. Otherwise the ticket is still listed, with the rating columns empty. The four supplied Customer Satisfaction Rating reports, two for incidents and two for service requests, read the rating from these lists, so they too leave out a rating you may not view.
Reference Tables
| Permission | Description |
|---|---|
| Brand Management | Allows adding, modifying, and deleting Brands |
| Company Address Management | Allows adding, modifying, and deleting Company Addresses |
Each is the only permission for its list; see Permissions with special rules.
Permissions with special rules
| Subject | Rule |
|---|---|
| Vendor Products | No permissions of their own; vendor products follow the Product permissions. In the Web App, editing and deleting a vendor product both check the Product Modify permission. |
| Brand Management, Company Address Management | Listed under Reference Tables. Each is described as allowing adding, modifying, and deleting the entries of its list. |
| Stock Room Management | Listed under Asset Management > Stock Room, not under Reference Tables. Same description as the two above. |
| Reports | Running reports is the Report class's View permission, described as allowing running reports. Which reports you then see depends on each report, as described below. The Web App checks the Report class's add, edit, delete, and view permissions before those actions on a report. |
| Knowledge Base articles | View All Articles admits every article. View admits articles in the Live status only. The article's Public flag plays no part. Organization restrictions of a role do not apply to articles; workspace restrictions do. |
| Announcements | Viewing announcements is not controlled by a permission a role can grant or withhold: the announcement view permission admits any account that belongs to at least one role. The Web App's Announcements list, however, also asks for Announcement Management: without it, the list opens with no rows. Neither role editor offers a view permission for announcements; both list Announcement Management and Manage Activities for them. In the Web App, editing and deleting an announcement need Announcement Management. Without it, an announcement opens read-only, and the Web App's navigation has no Announcements entry; an announcement still opens from a dashboard's Announcements widget or from a link to it. |
| Invoice Management | The only permission of the Invoice and Invoice Item classes, described as allowing adding, modifying, and deleting invoices. The Settings App's role editor lists it under the Purchase Order class; the Admin Center's role editor does not list it, so grant it in the Settings App. A role saved in the Admin Center no longer holds it. In the Web App, opening an invoice checks this permission for that record, with the role's organization and workspace restrictions, and without it the Web App shows an access-denied page instead of the invoice. Editing an invoice needs it; deleting one needs it and the Purchase Order Modify permission. The invoice list shows only the invoices it admits. |
| Built-in service persons | No account can open or edit the eleven built-in service identities, however privileged. |
Brand Management, Company Address Management, and Stock Room Management are each the only permission for their list, and a role's organization or workspace restriction does not limit them to particular entries. In the Web App, opening a brand, a company address, or a stock room checks the permission, and without it the Web App shows an access-denied page instead of the record. Editing or deleting an entry of any of the three lists also checks it.
In the Web App's report lists, a list report tied to one or more object classes is listed only when your roles hold one of those classes' View permissions and the license permits it. For Incident, for example, holding only View within group, View if Assignee, or View if Requester does not list a report that asks for Incident viewing. For Knowledge Base articles, a report asks for View, which admits live articles only, not View All Articles. The list report Service Desk largest objects is tied to no class and is listed for every account.
On a dashboard in the Web App, a Report List widget leaves out each report you may not see, without a placeholder.
Activity permissions
For each class that supports activities, a separate Manage Activities permission applies. You can edit or delete an activity only while all of these hold:
- You hold the class's Manage Activities permission.
- The record the activity belongs to is not open read-only.
- The activity's category is not flagged read-only. An activity whose category is not found counts as read-only.
In the Web App, an activity opens read-only unless you hold the class's Manage Activities permission and the activity itself is not flagged read-only.
Approval permissions
Approval stages and approval requests add checks on top of their own class permissions:
- Editing or deleting an approval stage or an approval request also needs the permission to edit the object being approved. The check passes when no related object is found.
- Viewing an approval stage also needs the permission to view the object being approved.
- An approval stage is listed only when the class of the object being approved is visible to you, or when that object is not found.
- Viewing an approval request needs only that the object's class is visible to you. A request addressed to you stays listed whatever its object's class.
The Web App applies the same checks when you view an approval stage or an approval request, and when you delete one.
Cross-cutting permission groups
These groups are not object classes. Both role editors list them under Management and Administration, the first top node, ahead of the object permissions, with the group names below.
| Group | Permission | What it controls |
|---|---|---|
| Management and Administration | Administrative Access | Neither role editor shows a description for it. See Administrative permissions. |
| Administrative Access | Basic Administrative Access | Described as granting access to administrative apps and tools. See Administrative permissions. |
| Advanced Administrative Functions | Batch Update | Described as allowing performing the Batch Update of multiple records. Running Batch Update on selected records in the Web App. Each selected record of a workflow class also needs its class's Modify permission; see Security Roles. |
| Advanced Administrative Functions | Recurrent Ticket Management | Described as granting access to the Recurrent Tickets feature. The Web App's navigation entry for recurrent tickets. |
| Advanced Administrative Functions | Local Snippets Management | Described as allowing adding, modifying, and deleting personal snippets. Personal snippets and categories in the Web App. |
| Advanced Administrative Functions | Shared Snippets Use | Described as allowing using shared snippets. Shared snippets and categories in the Web App. |
| Advanced Administrative Functions | Shared Snippets Management | Described as allowing adding, modifying, and deleting shared snippets. In the Web App, it adds nothing without Shared Snippets Use. In the Settings App, General > Shared Snippets shows its Categories group only to holders of this permission, or when a shared category exists. |
| Advanced Administrative Functions | Add New Tags | Described as allowing users to add new tags. Creating a tag in the Web App. |
| Views and Boards Management | Manage Shared Views and Boards | Described as allowing creating, modifying, and deleting any shared views and boards, regardless of their ownership. In the Web App, Manage Shared Views (Manage Shared Boards for boards) is offered only to its holders, and only they can save changes there. When they share a view, the audience list offers every active technician group that their Group class's View permission admits. |
| Views and Boards Management | Manage Personal Views and Boards | Described as allowing creating, modifying, and deleting personal views and boards. In the Web App, it also governs Save As, Export View, Import View, and New for boards. Making a shared view personal needs it: for a view you own, this permission alone; for another technician's view, together with Manage Shared Views and Boards. A default view cannot be made personal. |
| Views and Boards Management | Share Views and Boards | Described as allowing sharing personal views and boards, including their modifications. In the Web App, it lets you share your own views and boards and change shared views you own. When you share a view without also holding Manage Shared Views and Boards, the audience list offers only the technician groups you are a member of that your Group class's View permission admits. |
| Views and Boards Management | Export data | Described as allowing exporting data from views. Exporting a grid's rows in the Web App: without it, the Export button of a list's toolbar is disabled. |
| Analytics and Dashboard Management | Manage Shared Dashboards and Charts | Described as allowing creating, modifying, and deleting shared dashboards and analytics charts, regardless of their ownership. Dashboards and analytics charts: creating a shared one, and editing any shared one that is visible to you. |
| Analytics and Dashboard Management | Manage Personal Dashboards and Charts | Described as allowing creating, modifying, and deleting personal dashboards and analytics charts. Dashboards and analytics charts: creating or editing a private one. |
| Analytics and Dashboard Management | Share Dashboards and Charts | Described as allowing sharing dashboards and analytics charts, including their modifications. Dashboards and analytics charts: creating a shared one, and editing a shared one you own. |
| Analytics and Dashboard Management | Export data | Described as allowing exporting data from analytics charts. |
A change to a technician's snippet permissions reaches the Web App in the technician's next Web App session. A shared snippet saved in the Settings App is listed by the Web App's next snippet list request.
The dashboard and analytics chart rules in the table are those of the Web App. A default dashboard cannot be edited, whatever permissions you hold. The Web App reads the four permissions of Analytics and Dashboard Management once per Web App session and keeps the answers for the rest of that session.
In a database upgraded to 2026.1, every role that held the earlier single dashboard permission received all four permissions of Analytics and Dashboard Management; roles that did not hold it received none of them. The earlier permission, Dashboard Widgets under General, remains as a legacy administrative permission. The Settings App's permission tree shows it only while the database still contains a dashboard widget of one of the legacy widget types Chart, Table, Counters, or Latest Activities, and the Admin Center's permission tree does not show it.
The same upgrade kept group sharing: a view, board, dashboard view, or chart that was shared with a group stays shared with that group and follows the group's membership. A dashboard widget that was shared with roles became shared with the persons who were members of those roles at the upgrade, so joining such a role later does not make the widget visible. Each widget that existed before the upgrade was given an owner, an active person who held the earlier dashboard permission.
Roles do not decide which views, boards, dashboards, dashboard widgets, and charts a technician sees. The permissions of Views and Boards Management and Analytics and Dashboard Management decide only whether a technician may create, share, or export them. In the Web App, a technician sees an item they own, and a shared item that is shared with everyone or names the technician or one of the technician's groups.
Manage Shared Dashboards and Charts reaches only shared charts that are visible to you. When the person who owns a shared chart is deleted, the chart stays without an owner, and only holders of Manage Shared Dashboards and Charts to whom it is visible can edit it.
Administrative permissions
| Permission | What it allows |
|---|---|
| Administrative Access | In the Settings App, satisfies every administrative permission check except the Invoice Items business-logic right. In the Admin Center, satisfies the permission check of every page and menu entry. |
| Basic Administrative Access | The Settings App checks it at sign-in. Without it, the Settings App refuses with "You do not have enough permissions to use this function."; under automatic sign-in it asks for another sign-in instead. The Web App checks it before it signs you in to the Admin Center. Inside the Admin Center it opens no page by itself: a page or menu entry that checks a permission needs that permission or Administrative Access. The Import Wizard checks it the same way as the Settings App, unless it runs from the command line. |
| Security Management | In the Settings App, one right for all of security administration. It covers General > Workspaces, License Management, and the Users & Security node with every node under it: the Accounts and Roles folder with Accounts, Roles, and Applications, then User Sessions, Password Policy, and SSO Providers. The Settings App cannot let an administrator manage accounts but not roles. In the Admin Center, it is the single section permission for Users & Security, which covers the section's four pages: Accounts and Roles, Password Policy, User Sessions, and SSO Providers. It does not open the Workspaces and License Management pages of the Admin Center's General section: those two pages open only for Administrative Access, and no role editor offers a separate permission for them. Without Administrative Access, General has no Workspaces entry, and opening the page by its address shows "Sorry, this page is not available" and "You do not have enough permissions to access this page." In the Web App, it is also the permission behind the Bypass role-based access control check box of analytics charts. |
| AI Integration | Described as allowing managing AI Integration. In the Settings App, one right for the whole AI Integration branch, AI Configuration and AI Actions included; no separate right covers a part of it. In the Admin Center, AI Configuration, AI Actions, and the AI Assistant tab of a Self Service Portal instance open for this right or for Administrative Access. |
| Form Layout Configuration | In the Admin Center, the Form Layouts entry under an object class in the Workflow and Business Logic section needs this permission in addition to that class's business-logic right. Administrative Access satisfies both. The Settings App has no node for it. See Form Layouts. |
| Macros | In the Settings App, the right for the top-level Workflow and Business Logic > Macros node. A class's own Macros node is governed by that class's business-logic right instead. Opening a macro with the Placeholder Definition... command also checks Macros, and the Settings App refuses it to an account without that right. |
| System Macros | In the Settings App, the right for Workflow and Business Logic > Advanced > System Macros, the page that edits the link macros Web Portal Link, Self Service Portal Link, and API Link. |
| Business-logic rights | One administrative right per object class, for 41 classes, each named after the class's list (for example, Purchase Orders) and described as allowing managing that list's business logic. The role editor lists them under Business Logic Management. The Admin Center's role editor lists 40 of them: the right for Invoices is not among them, so grant it in the Settings App. |
The Settings App's role editor lists the business-logic rights in this order: All CIs, All Tickets/My Tickets, Announcements, Approval Requests, Approval Stages, Assets, Change Requests, Computers, Configurations, Consumables, Contracts, Documents, Library Items, Equipment Reservations, Groups, Hardware, Incidents, Invoices, Knowledge Base Articles, Locations, Networks, Organizations, Persons, Purchase Order Items, Problems, Products, Projects, Project Tasks, Purchase Orders, Services, Service Catalog Items, Service Requests, Service Level Agreements, Software Licenses, Software Catalog, Stock Rooms, Stock Rules, Tracked Software, Vendors, Vendor Products, Work Orders. The Admin Center's role editor lists the same rights in the same order, without Invoices.
In the Settings App, each node that carries a section right is hidden unless you hold that right or Administrative Access. General > Shared Snippets, for example, carries a section right of its own. A node that carries no section right, such as Administrative Dashboard, always shows. A parent shows when a child does. Opening a hidden node by other means shows "You do not have enough permissions to view this item."
The parent sections General, Logs, and Services are not stored as rights: holding the right of any child grants the parent. Business Logic is excluded from that rule and is checked against its own right, which the Settings App's role editor never stores; Administrative Access satisfies it.
In the Admin Center, a menu entry or page that checks a permission opens when you hold that permission or Administrative Access; an entry that checks no permission, such as General > Administrative Dashboard, always shows. Opening a page you may not open, for example by its address, shows "Sorry, this page is not available" and "You do not have enough permissions to access this page. Click here to go to the home page." Three sections open for any permission in a range rather than for one permission:
- Logs opens for Browse or Manage.
- Services and Integrations, with its Microsoft 365 Integration and Calendar Sharing pages, opens for any permission under Services Configuration Management, and also for Notifications, Web App Configuration, Self Service Portal Configuration, or API Configuration.
- Workflow and Business Logic opens for any business-logic right, and for Workflow Configuration, Configuration Parameters, System Macros, Form Layout Configuration, or Tags.
Invoice and Invoice Item resolve their business-logic right differently from the other classes:
- An account that holds the business-logic right of the Purchase Order class has the business-logic right for both.
- Invoice Item has no stored right of its own.
- The product does not ship a workflow parameter for Invoice Items processing. Where an administrator has added one and turned it on, every Settings App session holds the Invoice Items right.
- Administrative Access does not cover the Invoice Items right.
The database refuses a change that would make the technician making it lose Basic Administrative Access, or lose both Administrative Access and Security Management, whether the change removes the technician from a role or removes the permission from a role. Because the database enforces it, the rule holds in the Settings App and the Admin Center alike, and through the REST API; see Security Roles.
The administrative permission tree
In the role editor, Management and Administration > Administrative Access holds Basic Administrative Access and one permission per administrative area. Where parts of an area have permissions of their own, the role editor lists them under the area's permission:
| Permission | Described as | Permissions under it |
|---|---|---|
| General | Grants access to the General section | Object Identifiers, Object Relationship Map, Work Calendars, Report Settings, System Performance, Regional Settings, Upgrade and Migration, CSS Styles, Fields, Preview, View Forms, Shared Snippets, Help and Documentation. The Settings App's role editor also lists Dashboard Widgets, between Upgrade and Migration and CSS Styles, but only while the database contains a legacy dashboard widget; the Admin Center's role editor never lists it. |
| AI Integration | Allows managing AI Integration | - |
| Security Management | Allows managing Users and Security | - |
| Business Logic Management | Grants access to the Workflow and Business Logic section | The business-logic rights, then Workflow Configuration, Macros, Global Components, Configuration Parameters, Process Management, System Macros, Form Layout Configuration, Tags |
| Notifications | Allows managing Notifications | - |
| Services Configuration Management | Grants access to the Services section | Active Directory Integration, Alloy Discovery Integration, AlloyScan, Archiving, Scheduled Reports, Automation Server, Mobile Applications, Scheduled Tasks |
| Web App Configuration | Allows configuring Web App instances | - |
| Self Service Portal Configuration | Allows configuring Self Service Portal instances | - |
| API Configuration | Allows configuring API instances | - |
| Log Management | Grants access to the Logs section | Browse, described as allowing browsing logs; Manage, described as allowing managing log settings |
Unless the table says otherwise, each permission under an area is described as allowing managing the part it names; Process Management, for example, is described as allowing managing Business Logic Processes.
What each administrative permission opens
The table lists, for each administrative permission, the Settings App nodes and the Admin Center pages it opens. Administrative Access opens all of them, except as the Invoice rules above say.
| Permission | Settings App | Admin Center |
|---|---|---|
| Object Identifiers | General > Object Identifiers | General > Object Identifiers |
| Object Relationship Map | General > Object Relationship Map | The Object Relationship Map page, but not its menu entry: General lists the page only for Administrative Access, so with this permission alone the page opens only by its address. |
| Work Calendars | General > Work Calendars | General > Work Calendars |
| Report Settings | General > Report Settings | General > Report Settings |
| System Performance | General > System Performance | General > System Performance |
| Regional Settings | General > Regional Settings and General > Currencies | General > Language & Region. Currencies checks no permission and shows when the license includes multiple currencies. |
| Upgrade and Migration | General > Upgrade and Migration | No page |
| Dashboard Widgets | General > Dashboard Management > Widgets, shown only while the database contains a legacy dashboard widget | No page |
| CSS Styles | General > CSS Styles, with its Announcement, Knowledge Base Article, Service Catalog Item, Preview Pane, and Outgoing HTML Notification styles | General > CSS Styles |
| Fields | General > Fields | General > Fields |
| Preview | No node. CSS Styles > Preview Pane follows CSS Styles. | General > Preview, and the Preview entry under each object class in Workflow and Business Logic |
| View Forms | General > View Forms (Web App) | General > View Forms |
| Shared Snippets | General > Shared Snippets | No page |
| Help and Documentation | General > Help and Documentation | General > Help and Documentation |
| AI Integration | AI Integration > AI Configuration and AI Actions | AI Integration > AI Configuration and AI Actions; the AI Assistant tab of a Self Service Portal instance |
| Security Management | General > Workspaces, General > License Management, and Users & Security with every node under it | Users & Security: Accounts and Roles, Password Policy, User Sessions, SSO Providers |
| Business-logic rights | The class's node under its folder in Workflow and Business Logic, with Fields, View Form (Web App), Macros, Classification, and Workflow under it. All Configuration Items and Persons also have Options. Stock Rooms has only Classification and Workflow; Equipment Reservations and Vendor Products have Macros, Classification, and Workflow. | The class group's tile and the class's entry in Workflow and Business Logic. Under a class, Preview also needs Preview, and Form Layouts also needs Form Layout Configuration. |
| Workflow Configuration | Workflow and Business Logic > Workflow Configuration | Workflow and Business Logic > Workflow Configuration |
| Macros | Workflow and Business Logic > Macros | Workflow and Business Logic > Macros |
| Global Components | Workflow and Business Logic > Global Components > Functions and E-mail Notifications | No page |
| Configuration Parameters | Workflow and Business Logic > Advanced > Configuration Parameters | No page |
| Process Management | Workflow and Business Logic > Advanced > Processes | No page |
| System Macros | Workflow and Business Logic > Advanced > System Macros | No page |
| Form Layout Configuration | No node | Form Layouts under each object class |
| Tags | No node | Workflow and Business Logic > Tag Management |
| Notifications | Notifications: Global Settings, Notification Queue, Logs, E-mail Notifications (Settings, HTML Templates), and Push Notifications (Settings). E-mail Processing: Mail Connector, MessageID Tag, Preprocessing, Parsing, and Logs. | Notifications except SSP E-mail Templates, and E-mail Processing; also Services and Integrations with Microsoft 365 Integration and Calendar Sharing |
| Active Directory Integration | Services > Active Directory Integration: Synchronization, Domain Credentials, Logs | Services and Integrations > Active Directory Integration |
| Alloy Discovery Integration | Services > Alloy Discovery Integration: Conflict Resolution, Synchronization, Logs | Services and Integrations > Alloy Discovery Integration |
| AlloyScan | Services > AlloyScan: Synchronization, Logs | Services and Integrations > AlloyScan |
| Archiving | Services > Archiving: Archiving, Archive Databases, Logs. Not shown on Cloud or where the database is on Azure SQL. | No page |
| Scheduled Reports | Services > Scheduled Reports: Reports, Logs | Services and Integrations > Scheduled Reports |
| Automation Server | Services > Automation Server > Job List, and High Availability Mode except on Cloud | Services and Integrations > Automation Server |
| Mobile Applications | Services > Mobile Applications | Services and Integrations > Mobile Applications |
| Scheduled Tasks | Services > Scheduled Tasks: Tasks, Logs | Services and Integrations > Scheduled Tasks |
| Web App Configuration | No node | Apps and Portals > Web App |
| Self Service Portal Configuration | Self Service Portal: Self-Registration, Workflow, E-mail Templates | Apps and Portals > Self Service Portal, and Notifications > SSP E-mail Templates |
| API Configuration | No node | Apps and Portals > API |
| Browse | Every log under Logs, All Errors > Error Log included, read-only | Every tile under Logs, for viewing only |
| Manage | Every log under Logs, not read-only, and All Errors > Alerts | Every tile under Logs, All Errors > Alerts, and the Clear All, Delete, and Settings... commands of the log pages |
In the Settings App, a log inside another node, such as Services > Active Directory Integration > Logs, Notifications > Logs, or E-mail Processing > Logs, opens with that node's permission, not with Browse or Manage. Holding Manage without Browse also opens the logs under Logs.
With Browse alone, the Admin Center's log pages offer only View Log, and All Errors has only its Error Log tab.
Permissions and the license
The Settings App's role editor leaves out the classes the license does not cover, with all their permissions:
- Without the ITSM license module: Incident, Problem, Change Request, Work Order, Service Request, Service Catalog Item, Project, Project Task, SLA, Service, and Knowledge Base. The top nodes Service Management and Project Management are then not shown.
- Without the ITAM license module: Asset, Computer, Hardware, Network, Tracked Software, Software License, Document, Configuration, Purchase Order, Contract, Equipment Lending Library, Equipment Reservation, Vendor, Product, Stock Rule, Stock Room, and Consumable, Invoice Management and Stock Room Management included. The top nodes Asset Management, Purchasing, Configuration Management, and Software Asset Management are then not shown.
Whatever the license, the role editor lists the cross-cutting groups of Management and Administration and the groups Organization, Location, Person, Group, Approval Stage, Approval Request, Announcement, Report, Customer Satisfaction Rating, and Reference Tables.
The same rule leaves out the business-logic rights of those classes. Thirteen business-logic rights are listed whatever the license: All CIs, All Tickets/My Tickets, Announcements, Approval Requests, Approval Stages, Groups, Locations, Organizations, Persons, Purchase Order Items, Invoices, Software Catalog, and Vendor Products. Grants a role already holds for left-out classes stay stored until the role is next saved in the Settings App, which drops them.
The Admin Center's role editor does not filter by the license: it lists the classes of both license modules, whatever the license covers.
Of the permission checks the database makes, only the report list consults the license (see above); no other one does. The Web App's navigation and the classes that My Calendar offers also leave out what the license does not cover; see Security Roles. A license change reaches the Web App's navigation only after the Web App restarts.
Effective permissions in the Settings App
In the Settings App, a Technician account's window has the tabs General, Member Of, Effective Permissions, and Workflow Actions; the last three appear for Technician accounts only. See Accounts for accounts themselves.
Effective Permissions shows the role editor's permission tree read-only, with an Allow column and a Restricted column beside each permission, and the commands Expand All and Collapse All. For a restricted permission, it lists the workspaces and organizations that restrict it.
- A permission is allowed when any of the account's roles holds it.
- A permission is restricted when every role that grants it is organization-restricted, or when every role that grants it lists an active workspace. A permission granted by one organization-restricted role and one workspace-restricted role shows as unrestricted.
- A role that lists only inactive workspaces shows as unrestricted on this tab, although access checks count every listed workspace.
If you open the tab after changing the Member Of list, the Settings App asks "The record must be saved before proceeding with this action. Would you like to save the record now?" Yes validates and saves the account; No stays on the current tab.