Administration Guide

Permissions Reference

On this page

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.