Skip to content
Help Center
Submit a request Sign in

Configure agent roles and division access

Agent roles define staff permissions and division scope. Use roles that match job responsibilities so agents can complete their work without receiving unrelated access.

Applies to: Supportbench Core. Location: Settings → Organization → Roles. Access and available controls depend on your role and account capabilities.

Before you begin

  • You need permission to edit this configuration. Ask an administrator if the page is available but its editing controls are not.
  • Review the current configuration, its field reference and where it is used before making a change. Check the permissions and availability applicable to this feature.
  • Use a test record or a controlled test account for behavior checks. Do not change production routing or send customer messages just to try an example.

Configure and verify

  1. Open Settings → Organization → Roles.
  2. Find the item in the list and open it, or choose the page’s new-item action.
  3. Enter the required values and review the fields described below. Use the controls actually offered by this editor; do not assume it has the same settings as another configuration page.
  4. Save the item and resolve any validation message. Reopen it to confirm the saved values.
  5. Check the relevant selection list or form using a user with the intended access. Repeat for an excluded user or division when scope is restricted.

Delegate Chat policy administration

Manage Chat policy, in Permissions → Chat, lets a role create and update the account’s one Chat policy and read its Audit history. Use it when a support operations lead needs to choose the Company and Contact information agents see during conversations. It does not grant case-policy editing or access to otherwise restricted customer records or fields.

The built-in Administrator role receives this permission by default when the feature is provisioned. Other existing roles and newly created roles start with it off. Copying permissions from an enabled role can copy the grant, so review it before saving. Custom roles called “Admin” do not receive an automatic grant based on their name. Turning this permission off later is respected.

  1. Sign in with permission to administer agent roles, then open Settings → Organization → Roles.
  2. Open the role assigned to the operations lead. Select Permissions, then find the Chat permission group.
  3. Turn on Manage Chat policy and select Save Changes. Reopen the role to confirm the saved toggle. Leave unrelated case and customer permissions as required for that role.
  4. Have the affected agent refresh their session, then open Settings → Cases → Policy. A role with only this policy permission opens Chat policy directly. A role with both policy permissions can switch between Case policies and Chat policy.
  5. Follow Configure and audit the shared Chat policy to choose and order fields. Save a controlled change and expand Audit history to confirm the actor, time and change details.
  6. Verify that an agent without Manage Chat policy cannot open or save that configuration, while still seeing customer details they are otherwise allowed to read in Chat Console.

Example: give the Support Operations role Manage Chat policy so its lead can place the Company License number below Name. Leave the ordinary Support Agent role without this grant. Both roles can read the license number only when their existing customer access allows it. The lead’s layout save appears in the Chat policy history; agents continue using the account’s shared layout.

If the option is absent, first confirm that Chat is enabled and that your account has the matching feature update. Do not enable unrelated permissions as a workaround. If the tab is still denied after a grant, confirm the user’s assigned active role and refresh their session. Revoking Manage Chat policy prevents subsequent configuration and policy-history requests; it does not hide customer details from agents by itself. Use the policy’s visibility toggles for that purpose. Account-wide Audit Log access remains governed by its separate reporting permission.

Delegate knowledge ordering without article editing

Open Settings → Organization → Roles, open the intended role, and use Permissions → Knowledge Base → Arrange knowledge base content. Review the role’s Division scope and choose Save Changes. Reopen Settings with a representative agent and verify the intended topic and Save order action.

This permission does not grant article editing, publishing, pinning or subscriber management. When the separate option is absent or still inherited, existing Edit topics access applies. Saving an unchanged inherited value keeps that inheritance; explicitly changing the checkbox sets a grant or denial. An explicit denial blocks arrangement even when Edit topics remains enabled.

The separate permission option and custom-order storage have distinct availability requirements. If the option or ordering controls are unavailable, check account capabilities and the applicable Core release with your administrator. A saved role is not proof that a particular account’s ordering prerequisites have been completed.

Settings reference

Role profile and division scope

SettingWhat it controlsHow to choose
NameThe name shown in selectors and lists.Choose a distinct operational name.
DescriptionExplains the intended purpose and audience.Describe ownership and when to use it.
ActiveControls whether the item is available for normal use.Review existing references before deactivation.
DivisionsConfigures Division scope for case visibility. Both an empty selection and all active Divisions selected store unrestricted scope. A proper subset creates a narrower selection; selected roots include descendants.Check included and excluded cases with a representative user. Case-view permission and record-level access, including own-assigned and uncategorized cases, also apply.
Select all / Select noneChanges the Division selection as a group. Saving either no selected Divisions or all active Divisions normalizes to unrestricted scope.Select none is not deny all. Choose some, but not all, active Divisions for a narrower configured scope and verify the saved result.

Permissions and copying

SettingWhat it controlsHow to choose
PermissionsSearchable groups of server-defined permissions.Read each permission’s label and enable only the capabilities required for the job.
Copy RoleCopies permissions and division scope from an active role. Name, description and active state are retained.Select Copy from and choose Apply, then inspect every affected permission group and Division before Save Changes.

Permissions: Agent

SettingWhat it controlsHow to choose
Update personal detailsAllows agents with this role to use this permission: Update personal details.Enable only when needed for this role; verify the relevant operation with a representative agent.
Update profile imageAllows agents with this role to use this permission: Update profile image.Enable only when needed for this role; verify the relevant operation with a representative agent.
Update job titleAllows agents with this role to use this permission: Update job title.Enable only when needed for this role; verify the relevant operation with a representative agent.
Change working hoursAllows agents with this role to use this permission: Change working hours.Enable only when needed for this role; verify the relevant operation with a representative agent.
Update email signatureAllows agents with this role to use this permission: Update email signature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Update out-of-office settingsAllows agents with this role to use this permission: Update out-of-office settings.Enable only when needed for this role; verify the relevant operation with a representative agent.
Update advanced settingsAllows agents with this role to use this permission: Update advanced settings.Enable only when needed for this role; verify the relevant operation with a representative agent.
Use and view the calendarAllows agents with this role to use this permission: Use and view the calendar. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Add or remove asset associationsAllows agents with this role to use this permission: Add or remove asset associations. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Disable or enable asset associationsAllows agents with this role to use this permission: Disable or enable asset associations. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
View survey resultsAllows agents with this role to use this permission: View survey results. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Create global and team-only viewsAllows agents with this role to use this permission: Create global and team-only views.Enable only when needed for this role; verify the relevant operation with a representative agent.
View audit trailsAllows agents with this role to use this permission: View audit trails.Enable only when needed for this role; verify the relevant operation with a representative agent.
View discussionsAllows agents with this role to use this permission: View discussions.Enable only when needed for this role; verify the relevant operation with a representative agent.
Watch itemsAllows agents with this role to use this permission: Watch items.Enable only when needed for this role; verify the relevant operation with a representative agent.

Permissions: Agent Administration

SettingWhat it controlsHow to choose
Alter other agent profilesAllows agents with this role to use this permission: Alter other agent profiles.Enable only when needed for this role; verify the relevant operation with a representative agent.
View other agent profilesAllows agents with this role to use this permission: View other agent profiles.Enable only when needed for this role; verify the relevant operation with a representative agent.
Create new agentsAllows agents with this role to use this permission: Create new agents.Enable only when needed for this role; verify the relevant operation with a representative agent.
Impersonate other agentsAllows agents with this role to use this permission: Impersonate other agents.Limit to the people who need this operation and verify the resulting scope with a test agent.

Permissions: {case.plural|Cases}

SettingWhat it controlsHow to choose
Create new casesAllows agents with this role to use this permission: Create new cases.Enable only when needed for this role; verify the relevant operation with a representative agent.
Tweet from casesAllows agents with this role to use this permission: Tweet from cases. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Hide cases and activities from the customer portalAllows agents with this role to use this permission: Hide cases and activities from the customer portal.Enable only when needed for this role; verify the relevant operation with a representative agent.
Transfer cases to the trash in bulkAllows agents with this role to use this permission: Transfer cases to the trash in bulk.Enable only when needed for this role; verify the relevant operation with a representative agent.
Close cases in bulkAllows agents with this role to use this permission: Close cases in bulk.Enable only when needed for this role; verify the relevant operation with a representative agent.
Close casesAllows agents with this role to use this permission: Close cases.Enable only when needed for this role; verify the relevant operation with a representative agent.
Alter closed date on casesAllows agents with this role to use this permission: Alter closed date on cases.Enable only when needed for this role; verify the relevant operation with a representative agent.
View all casesAllows agents with this role to use this permission: View all cases.Enable only when needed for this role; verify the relevant operation with a representative agent.
Delete case surveysAllows agents with this role to use this permission: Delete case surveys. This choice depends on the corresponding enabled feature.Limit to the people who need this operation and verify the resulting scope with a test agent.
Alter SLA dates on casesAllows agents with this role to use this permission: Alter SLA dates on cases.Enable only when needed for this role; verify the relevant operation with a representative agent.
View escalated casesAllows agents with this role to use this permission: View escalated cases.Enable only when needed for this role; verify the relevant operation with a representative agent.
Edit activity contentAllows agents with this role to use this permission: Edit activity content.Enable only when needed for this role; verify the relevant operation with a representative agent.
Alter case creation datesAllows agents with this role to use this permission: Alter case creation dates.Enable only when needed for this role; verify the relevant operation with a representative agent.
Favorite queuesAllows agents with this role to use this permission: Favorite queues.Enable only when needed for this role; verify the relevant operation with a representative agent.
Delete activitiesAllows agents with this role to use this permission: Delete activities.Limit to the people who need this operation and verify the resulting scope with a test agent.
Create activities, bulk respond and forwardCreate Case activities, including Bulk response and Bulk forward. Both bulk actions use this permission; Case access and attachment restrictions still apply.Enable only when needed for this role; verify the relevant operation with a representative agent.
Link cases together in bulkAllows agents with this role to use this permission: Link cases together in bulk.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer case templatesAllows agents with this role to use this permission: Administer case templates.Enable only when needed for this role; verify the relevant operation with a representative agent.
Create global and team-only templatesAllows agents with this role to use this permission: Create global and team-only templates.Enable only when needed for this role; verify the relevant operation with a representative agent.
Use scenario checklistsAllows agents with this role to use this permission: Use scenario checklists.Enable only when needed for this role; verify the relevant operation with a representative agent.
Create personal scenarios from the pickerAllows agents with this role to use this permission: Create personal scenarios from the picker.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer all scenariosAllows agents with this role to use this permission: Administer all scenarios.Limit to the people who need this operation and verify the resulting scope with a test agent.

Permissions: {case.singular|Case} Administration

SettingWhat it controlsHow to choose
Administer case policiesAllows agents with this role to use this permission: Administer case policies.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer divisionsAllows agents with this role to use this permission: Administer divisions.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer case prioritiesAllows agents with this role to use this permission: Administer case priorities.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer support levelsAllows agents with this role to use this permission: Administer support levels.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer activity typesAllows agents with this role to use this permission: Administer activity types.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer case statesAllows agents with this role to use this permission: Administer case states.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer link typesAllows agents with this role to use this permission: Administer link types.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer case escalation typesAllows agents with this role to use this permission: Administer case escalation types.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer case resolution typesAllows agents with this role to use this permission: Administer case resolution types.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer case issue typesAllows agents with this role to use this permission: Administer case issue types.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer projectsAllows agents with this role to use this permission: Administer projects. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer data maskingAllows agents with this role to use this permission: Administer data masking.Enable only when needed for this role; verify the relevant operation with a representative agent.

Permissions: Companies

SettingWhat it controlsHow to choose
Add company data table itemsAllows agents with this role to use this permission: Add company data table items. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Update company data table itemsAllows agents with this role to use this permission: Update company data table items. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Delete company data table itemsAllows agents with this role to use this permission: Delete company data table items. This choice depends on the corresponding enabled feature.Limit to the people who need this operation and verify the resulting scope with a test agent.
Create and update companiesAllows agents with this role to use this permission: Create and update companies.Enable only when needed for this role; verify the relevant operation with a representative agent.
Delete companiesAllows agents with this role to use this permission: Delete companies.Limit to the people who need this operation and verify the resulting scope with a test agent.
Import companies from CSVAllows agents with this role to use this permission: Import companies from CSV.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer company and contact configurationsAllows agents with this role to use this permission: Administer company and contact configurations.Enable only when needed for this role; verify the relevant operation with a representative agent.

Permissions: Contacts

SettingWhat it controlsHow to choose
Add contact data table itemsAllows agents with this role to use this permission: Add contact data table items. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Update contact data table itemsAllows agents with this role to use this permission: Update contact data table items. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Delete contact data table itemsAllows agents with this role to use this permission: Delete contact data table items. This choice depends on the corresponding enabled feature.Limit to the people who need this operation and verify the resulting scope with a test agent.
Administer contactsAllows agents with this role to use this permission: Administer contacts.Enable only when needed for this role; verify the relevant operation with a representative agent.
Delete contactsAllows agents with this role to use this permission: Delete contacts.Limit to the people who need this operation and verify the resulting scope with a test agent.
Import contacts from CSVAllows agents with this role to use this permission: Import contacts from CSV.Enable only when needed for this role; verify the relevant operation with a representative agent.
Impersonate contacts in the customer portalAllows agents with this role to use this permission: Impersonate contacts in the customer portal.Limit to the people who need this operation and verify the resulting scope with a test agent.

Permissions: Knowledge Base

SettingWhat it controlsHow to choose
Administer article topicsAllows agents with this role to use this permission: Administer article topics. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Arrange knowledge base contentArrange topics and articles without editing or publishing content. Existing topic editors retain access until this permission is explicitly changed. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Manage knowledge-base tagsCreate, rename, merge, retire and delete unused knowledge-base tags. Does not grant article editing or visibility. This choice depends on the corresponding enabled feature.Limit to the people who need this operation and verify the resulting scope with a test agent.
Manage article search keywordsCreate, assign, change and remove Search keywords on articles you can edit. Does not grant article editing, publishing, Tags or AI Terms permissions. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer article templatesAllows agents with this role to use this permission: Administer article templates. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Manage knowledge base stylesCreate, edit and retire shared knowledge base styles and callouts. This choice depends on the corresponding enabled feature.Limit to the people who need this operation and verify the resulting scope with a test agent.
Create articlesAllows agents with this role to use this permission: Create articles. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Create article drafts from cases and chatsCreate a draft from an accessible case or chat using AI and submit it for review. Without Create articles, only review submission is allowed; this does not grant knowledge-base access, existing article editing, or publishing. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Alter existing articlesAllows agents with this role to use this permission: Alter existing articles. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Publish articles publiclyAllows agents with this role to use this permission: Publish articles publicly. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Archive existing articlesAllows agents with this role to use this permission: Archive existing articles. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Manage article redirectsCreate, change, and remove knowledge base redirects. This choice depends on the corresponding enabled feature.Limit to the people who need this operation and verify the resulting scope with a test agent.
Manage shared knowledge base viewsCreate, edit and delete any knowledge base view shared with Teams, Agents or Global audiences. Personal views remain private. This choice depends on the corresponding enabled feature.Limit to the people who need this operation and verify the resulting scope with a test agent.
Delete ratings and commentsAllows agents with this role to use this permission: Delete ratings and comments. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Articles require review before publishingRequires this role’s articles to pass the configured review workflow; this is a restriction on direct publication. This choice depends on the corresponding enabled feature.Enable when this restriction matches the role’s responsibilities; test the restricted and permitted paths.
Administer the file repositoryAllows agents with this role to use this permission: Administer the file repository. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer article review groupsAllows agents with this role to use this permission: Administer article review groups. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer article variablesAllows agents with this role to use this permission: Administer article variables. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Flag articles for reviewAllows agents with this role to use this permission: Flag articles for review. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer flagged articlesAllows agents with this role to use this permission: Administer flagged articles. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer AI TermsAllows agents with this role to use this permission: Administer AI Terms. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.

Permissions: KCS Quality

SettingWhat it controlsHow to choose
View quality insightsAllows agents with this role to view quality insights. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
View AI evidenceAllows agents with this role to view AI evidence. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Review answersAllows agents with this role to review answers. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Run verification testsAllows agents with this role to run verification tests. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Manage quality workflowAllows agents with this role to manage quality workflow. This choice depends on the corresponding enabled feature.Limit to the people who need this operation and verify the resulting scope with a test agent.

Permissions: Calendar

SettingWhat it controlsHow to choose
View other agent eventsAllows agents with this role to use this permission: View other agent events. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Add new and update eventsAllows agents with this role to use this permission: Add new and update events. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Update events on other agent calendarsAllows agents with this role to use this permission: Update events on other agent calendars. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer team calendarsAllows agents with this role to use this permission: Administer team calendars. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer global calendarsAllows agents with this role to use this permission: Administer global calendars. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.

Permissions: Assets

SettingWhat it controlsHow to choose
Administer assetsAllows agents with this role to use this permission: Administer assets. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer asset categoriesAllows agents with this role to use this permission: Administer asset categories. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.

Permissions: Community

SettingWhat it controlsHow to choose
Administer communitiesAllows agents with this role to use this permission: Administer communities. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.

Permissions: Chat

SettingWhat it controlsHow to choose
View all agent chatsAllows agents with this role to use this permission: View all agent chats. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
View chat overviewView current agent workload and read-only chats. Requires View all agent chats; follows selected work queues and ALL. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer chat widgetsAllows agents with this role to use this permission: Administer chat widgets. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Manage Chat policyCreate and update the shared Chat Console customer-details policy and view its audit history. Does not grant case-policy or customer-record access. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.

Permissions: JIRA

SettingWhat it controlsHow to choose
Create and comment on JIRA itemsAllows agents with this role to use this permission: Create and comment on JIRA items. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Search and link JIRA issuesAllows agents with this role to use this permission: Search and link JIRA issues. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.

Permissions: Linear

SettingWhat it controlsHow to choose
Create and comment on Linear itemsAllows agents with this role to use this permission: Create and comment on Linear items. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.

Permissions: Azure DevOps

SettingWhat it controlsHow to choose
Create and comment on DevOps itemsAllows agents with this role to use this permission: Create and comment on DevOps items. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.

Permissions: AI

SettingWhat it controlsHow to choose
Global AI settingsAllows agents with this role to use this permission: Global AI settings.Enable only when needed for this role; verify the relevant operation with a representative agent.
AI columns in viewsAllows agents with this role to use this permission: AI columns in views. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
Editor AI functionsAllows agents with this role to use this permission: Editor AI functions.Enable only when needed for this role; verify the relevant operation with a representative agent.
AI searching in main searchAllows agents with this role to use this permission: AI searching in main search. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
AI case insightsAllows agents with this role to use this permission: AI case insights. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
AI reportingAllows agents with this role to use this permission: AI reporting. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.

Permissions: Broadcasts

SettingWhat it controlsHow to choose
Create and update broadcastsAllows agents with this role to use this permission: Create and update broadcasts.Enable only when needed for this role; verify the relevant operation with a representative agent.
View broadcast analyticsAllows agents with this role to use this permission: View broadcast analytics.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer unsubscribe listAllows agents with this role to use this permission: Administer unsubscribe list.Enable only when needed for this role; verify the relevant operation with a representative agent.

Permissions: Reporting

SettingWhat it controlsHow to choose
View the dashboardAllows agents with this role to use this permission: View the dashboard.Enable only when needed for this role; verify the relevant operation with a representative agent.
View case KPI reportsAllows agents with this role to use this permission: View case KPI reports.Enable only when needed for this role; verify the relevant operation with a representative agent.
View knowledge base analyticsAllows agents with this role to use this permission: View knowledge base analytics. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
View community analyticsAllows agents with this role to use this permission: View community analytics. This choice depends on the corresponding enabled feature.Enable only when needed for this role; verify the relevant operation with a representative agent.
View agent KPI reportsAllows agents with this role to use this permission: View agent KPI reports.Enable only when needed for this role; verify the relevant operation with a representative agent.
View team and division KPI reportsAllows agents with this role to use this permission: View team and division KPI reports.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer KPI scorecardsAllows agents with this role to use this permission: Administer KPI scorecards.Enable only when needed for this role; verify the relevant operation with a representative agent.
View user availability reportsView recorded availability for all users in this account, compare teams and users, and export to Excel.Enable only when needed for this role; verify the relevant operation with a representative agent.
Schedule data viewsAllows agents with this role to use this permission: Schedule data views.Enable only when needed for this role; verify the relevant operation with a representative agent.
Schedule and administer global data viewsAllows agents with this role to use this permission: Schedule and administer global data views.Enable only when needed for this role; verify the relevant operation with a representative agent.
Restrict agent to only view their metricsRestricts the role to its own dashboard; enabling this is a restriction, not wider dashboard access.Enable when this restriction matches the role’s responsibilities; test the restricted and permitted paths.

Permissions: Administration

SettingWhat it controlsHow to choose
Administer account details and styleAllows agents with this role to use this permission: Administer account details and style.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer account policiesAllows agents with this role to use this permission: Administer account policies.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer agent rolesAllows agents with this role to use this permission: Administer agent roles.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer teamsAllows agents with this role to use this permission: Administer teams.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer queuesAllows agents with this role to use this permission: Administer queues.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer fieldsAllows agents with this role to use this permission: Administer fields.Enable only when needed for this role; verify the relevant operation with a representative agent.
Manage system workflowsAllows agents with this role to use this permission: Manage system workflows.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer outbound email addressesAllows agents with this role to use this permission: Administer outbound email addresses.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer email routesAllows agents with this role to use this permission: Administer email routes.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer web widgetsAllows agents with this role to use this permission: Administer web widgets.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer survey engineAllows agents with this role to use this permission: Administer survey engine.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer API configurationsAllows agents with this role to use this permission: Administer API configurations.Limit to the people who need this operation and verify the resulting scope with a test agent.
Administer messages and notificationsAllows agents with this role to use this permission: Administer messages and notifications.Enable only when needed for this role; verify the relevant operation with a representative agent.
Access system logsAllows agents with this role to use this permission: Access system logs.Enable only when needed for this role; verify the relevant operation with a representative agent.
Administer billingAllows agents with this role to use this permission: Administer billing.Limit to the people who need this operation and verify the resulting scope with a test agent.
Administer all integrationsAllows agents with this role to use this permission: Administer all integrations.Enable only when needed for this role; verify the relevant operation with a representative agent.

Behavior to know

  • Viewing a Settings page and editing its records can require different permissions.
  • Role changes can widen access across many features; evaluate the permission and division scope together.
  • Select none does not deny all Divisions. Empty and all-selected sets are unrestricted; verify a proper subset, an excluded case and any own-assigned case exception.
  • Assign the reviewed role separately in Settings → Organization → Agents → Assignment & routing. Role, Division and Primary team are distinct controls; refresh the representative session and test the complete workflow.
  • New roles begin without granted permissions. Some groups depend on enabled modules or Knowledge Quality availability. A missing permission is not automatically granted.
  • Requires review and Only view own dashboard are restrictions; review their effect separately from ordinary permission grants.

Recommended use

  • Use terminology that agents and customers already understand. Explain the intended meaning in the description.
  • Keep the initial configuration small enough for people to choose consistently. Add options when they represent a real operational difference.
  • Review existing references before renaming, changing scope, or deleting. Where supported, deactivate an obsolete option before considering permanent deletion.

Worked example

  1. Create a role for a defined support responsibility.
  2. Copy an appropriate active role if it gives a useful starting point.
  3. Review its division scope and permission groups.
  4. Save and test both permitted and prohibited operations using a representative test agent.
  5. Have the affected user refresh permissions or sign in again before checking the result.

Troubleshooting

ProblemWhat to check
The item is missing from a picker.Compare the saved definition and the consuming form with this feature’s field reference and access requirements. Check only the availability or scope controls this editor actually provides, then reopen the consuming form.
The form rejects a save.Read the displayed validation message. Check required values, text limits and permitted scope; do not change unrelated settings to bypass validation.
An existing record still shows an old value.A configuration change and a record change are different operations. Inspect the record and relevant references before assuming the save failed.
  • Organization → Configure agents, profiles and availability
  • Organization → Configure divisions
  • Customers → Configure customer roles

Was this article helpful?