Permissions

Roles & Permissions

Create roles, choose their module access and permissions, set the default role for new members, assign roles to people, and look up every permission with the Member and Admin defaults.

A role is a named set of capabilities. Every member holds exactly one, and it decides what they can do across the organization: which modules they see, what they can create, what they can change, and which settings they can reach. Roles are one half of the access model; the other is per-object Sharing & Access. If you are new to the split, read Understanding Permissions first.

The built-in roles

Every organization starts with three. Admin and Member are ordinary roles you can rename, retune, or delete; Owner is not.

RoleWhat it holdsNotes
OwnerEverything, alwaysLocked: no rename, edit, or delete. Exactly one per organization, and at least one active member must hold it. Only an Owner can give someone the Owner role.
AdminEvery permission in the matrixOperationally the same as Owner; the difference is that it can't promote anyone to Owner. Every permission added later reaches it when the permission ships.
MemberThe contributor set: create and manage your own items, workstreams, comments, and time entries; create and manage your own boards, Gantts, automations, saved views, item templates, and API keys; open the Service Desk and send public replies. Module Access to Map, Boards, Gantt, Items, Automations, and Templates, but not Reports or Settings.The starting point for a new member unless you change the default.

The Permissions page

Open Configure Settings, then under Admin choose Permissions.

  • The Roles rail on the left lists every role. The Owner is pinned at the top with a lock. Each other role has three icons: a pin (filled on the role that is the default for new members; click a hollow one to make that role the default), a pencil to Rename role, and an x to Delete role.
  • New Role at the top of the rail creates a role.
  • Selecting a role shows its detail on the right: the name and description, a banner reading Editing permissions here affects N members with their avatars (or "No members are currently assigned to this role"), then Module Access, then Permissions.

Toggles save the moment you flip them. There is no Save button and no draft state, so read the affected-members banner before you start.

Create a role

  1. Click New Role.
  2. Enter a Name and, optionally, a Description ("what does this role do?"), then click Create role. The role starts with nothing switched on.
  3. Switch on the modules the role should see under Module Access.
  4. Switch on its capabilities under Permissions. Each row shows the permission's name, a one-line description, and, where it applies, a Requires: line naming its prerequisites.

Prerequisites cascade

Permissions form a ladder: Manage All … requires Manage Own …, which requires Create …; comments and time entries require Create Items And Workstreams; every Settings permission requires the Settings module. Switching a permission on also turns on everything it requires. Switching one off also turns off everything that depends on it. So turning off Create Items And Workstreams silently removes comments, time entries, and both Manage tiers for items; check the matrix afterwards.

Two toggles that work in reverse

Time Entry Access (under Time Entries) and the per-plugin rows under Module Access are on for every role by default. Switch Time Entry Access off to remove every time-entry surface from the role: the item drawer's Time Tracking tab, the sidebar's Time Spent control, and the time-spent cell in the Items table. The three time-entry permissions beneath it turn off and read "Unavailable while Time Entry Access is off for this role" until you switch it back on.

Module Access

ModuleWhat it opens
MapMap Value (the workstream portfolio)
BoardsPlan Delivery: boards, folders, and cycles
GanttTrack Progress
ReportsMeasure Performance (the reports still need the matching Read Report … permissions)
AutomationsAutomate Workflows
ItemsThe Items list
SettingsConfigure Settings (each section inside also needs its own Manage … permission)
Service DeskThe Service Desk module, once the desk is enabled for the organization
TemplatesThe Templates module

A module switch controls the sidebar entry and the route only. It does not change what the API or MCP tools allow, and a module can be locked on when a permission the role holds needs it ("Required by capability permissions this role holds").

Plugin menus

Enabled plugins appear in the navigation for every role by default. To take one away from a role, switch off that plugin's row in the role's Module Access ("Turn off to block this plugin's menu item"). This hides the menu entry only; it grants or removes no other permission, and roles you have not touched keep seeing every plugin.

Set the default role for new members

Click the hollow pin on a role in the Roles rail. New invitations take that role automatically; existing members are unaffected. The default role can't be deleted until you point the default at another role, and the Owner role can't be the default.

Rename or delete a role

Use the pencil and x icons in the Roles rail. A role with members still assigned can't be deleted; move them to another role first. The Owner role can't be renamed or deleted.

Assign a role to a member

  1. Open Configure Settings, then under Organization choose Users. The Access role column shows each member's role.
  2. Open the member's Edit User dialog and choose a role under Access role.

Three rules apply: you can't change your own access role, you can't change the role of an Owner, and only an Owner can assign the Owner role. New invitees get the default role; change it in Edit User afterwards if needed. For inviting and archiving members, see Users, roles, and MFA.

Who can edit roles

Editing roles requires the Manage Permissions permission (under Settings → Organization). Owner and the default Admin hold it. Treat it as a master key: a member with Manage Permissions and Manage Users can build a role with every permission and assign it to themselves. The only thing they still can't do is make anyone an Owner.

Changes take effect within seconds

Changing a role, or a member's role, reaches them within seconds without a sign-out. If a change removes access to something they are viewing, it is removed from their screen and they are told why.

Permission reference

Every permission as the matrix lists it, with its description and whether the Admin role, and the default Member role of a newly created organization, hold it. The Owner always has everything. "Admin override" means the permission reaches other members' content.

Module Access

PermissionMemberAdmin
Map, Boards, Gantt, Automations, Items, Service Desk, Templatesyesyes
Reports, Settingsnoyes
Plugin rows (one per installed plugin)onon

Workstreams / Items

PermissionWhat it grantsMemberAdmin
Create Items And WorkstreamsCreate new work items and workstreams.yesyes
Manage Own Items And WorkstreamsUpdate, archive, and delete work items and workstreams where you have Owner-level sharing.yesyes
Manage All Items And WorkstreamsRead, update, archive, and delete any work item or workstream, regardless of sharing. Admin override.noyes
Backdate Item HistoryRecord an item's created date, creator, and status or board history as happening in the past, and correct them later. Requires Manage Own Items And Workstreams. See Correcting an item's real history.noyes

Comments

PermissionWhat it grantsMemberAdmin
Create CommentPost new comments on work items and workstreams.yesyes
Manage Own CommentsEdit and delete comments you authored.yesyes
Manage All CommentsEdit and delete other members' comments. Admin moderation override.noyes

Time Entries

PermissionWhat it grantsMemberAdmin
Time Entry AccessOn by default. Off removes every time-entry surface from the role.onon
Create Time EntriesLog time entries on work items.yesyes
Manage Own Time EntriesEdit and delete time entries you authored.yesyes
Manage All Time EntriesEdit and delete other members' time entries. Admin moderation override.noyes

Boards

PermissionWhat it grantsMemberAdmin
Create BoardCreate new boards and board folders.yesyes
Manage Own BoardsUpdate, archive, and delete boards and folders where you have Owner-level sharing.yesyes
Manage All BoardsRead, update, archive, and delete any board or folder, regardless of sharing. Admin override.noyes

Gantts

PermissionWhat it grantsMemberAdmin
Create GanttCreate new Gantts.yesyes
Manage Own GanttsUpdate and delete Gantts you authored, including their initiatives, milestones, scenarios, and Gantt items.yesyes
Manage All GanttsUpdate and delete other members' Gantts. Admin override.noyes

Reports

Viewing a report includes exporting it. None of these is granted to the default Member role.

PermissionWhat it grantsMemberAdmin
Read Report Current ProgressView the Current Progress report.noyes
Read Report TrendingView the Trending Progress, Burn Down, and Burn Up reports.noyes
Read Report ThroughputView the Throughput report (also unlocks the Service Desk Reports tab).noyes
Read Report Cumulative FlowView the Cumulative Flow report.noyes
Read Report ChurnView the Churn report.noyes
Read Report VelocityView the Velocity report.noyes
Read Report Cycle TimeView the Cycle Time report.noyes
Read Report Time TrackingView the User Time Tracking and Time Allocation Matrix reports. Reports are organization-wide: they include time on items the viewer can't open.noyes

Automations

PermissionWhat it grantsMemberAdmin
Create AutomationCreate new automations.yesyes
Manage Own AutomationsUpdate, enable/disable, and delete automations you authored.yesyes
Manage All AutomationsUpdate, enable/disable, and delete other members' automations. Admin override.noyes

Service Desk

PermissionWhat it grantsMemberAdmin
Send Public RepliesSend customer-visible replies on tickets. Without it a member can only add internal notes.yesyes
Manage RequestersCreate, edit, block, merge, and anonymize requesters and companies; open tickets for clients.noyes
Manage Service Desk SettingsService desk enablement, inbound addresses and sending domains, SLA policies, schedules, portal branding, and request forms. Requires the Settings module.noyes

Knowledge Base

PermissionWhat it grantsMemberAdmin
Create Kb ArticlesCreate articles and edit your own unpublished drafts.noyes
Manage Own Kb ArticlesEdit articles you authored, including after publication.noyes
Manage All Kb ArticlesEdit any member's articles. Admin override.noyes
Publish Kb ArticlesPublish, unpublish, and archive articles, edit slugs and audience, and manage the category tree.noyes
Comment On Kb ArticlesComment in article review threads; edit and delete your own article comments.noyes
Moderate Kb Article CommentsDelete, redact, resolve, and edit any member's article comments. Admin override.noyes
Manage Knowledge Base SettingsKnowledge Base settings, such as the stages a spec moves through. Requires the Settings module.noyes

The descriptions above are the ones shown in the app. Manage Knowledge Base Settings opens Configure Settings → Knowledge Base, where the workspace's spec stages are set up; when it was added, admin roles and roles holding both Manage All Kb Articles and the Settings module were given it. One newer ability rides on an existing permission: Publish Kb Articles also approves or sends back proposed changes to published articles and moves articles into publishers-only stages. Likewise Manage All Kb Articles is what lets someone switch on a Spec Reached a Stage automation (see Specs and work items), and linking a spec to work items needs Create Kb Articles.

See Knowledge Base permissions for how these shape the module.

Saved Views

PermissionWhat it grantsMemberAdmin
Create Stored ViewCreate new saved views.yesyes
Manage Own Stored ViewsUpdate and delete saved views you authored (also needed to publish a view to portal customers).yesyes
Manage All Stored ViewsUpdate and delete other members' saved views. Admin override.noyes

Item Templates

PermissionWhat it grantsMemberAdmin
Create Item TemplateCreate new templates.yesyes
Manage Own Item TemplatesUpdate and delete templates you authored.yesyes
Manage All Item TemplatesUpdate and delete other members' templates. Admin override.noyes

API Keys

PermissionWhat it grantsMemberAdmin
Create Api KeyCreate API keys for yourself.yesyes
Manage Own Api KeysUpdate and delete your own API keys.yesyes
Manage All Api KeysView, update, and delete other members' API keys, for example to revoke a departed member's keys. Admin override.noyes
Manage Agent ClaimsTake, renew, release and hand over agent work claims, and read who holds what. For teams whose AI agents coordinate through DevStride (see the agent work claims tools in the Tool Reference). Also opens Configure Settings → AI Assistants → Agent Fleet, which also needs access to Settings.noyes

AI Assistant

PermissionWhat it grantsMemberAdmin
Use Ai AssistantOpen the AI Assistant and chat with it. Every role that existed when the assistant launched received it.yesyes
Manage Ai AssistantSwitch the assistant on or off, and choose which sources and models it may use; also opens Configure Settings → AI Assistants → Connect AI, the page for connecting an external AI client over MCP. Requires the Settings module.noyes
View Ai UsageSee AI Assistant usage and cost for the organization. Requires the Settings module. There is no usage page yet, so today it shows nothing.noyes

See AI Assistant for what the assistant does and Settings, Permissions & Your Data for how to manage it.

Settings

Every Settings permission requires the Settings module; the Data Model and Other groups additionally require Manage Org Configuration. The default Member role holds none of them. The groups below follow the Settings menu, and the Permissions page groups them the same way.

Organization

PermissionWhat it grantsAdmin
Manage Org ConfigurationEdit the Organization Profile. It also opens two Admin pages, Global Automations and Formatting Rules.yes
Manage UsersBrowse, invite, change role and team assignment, and remove members.yes
Manage TeamsCreate, edit, and delete teams.yes

Data Model

PermissionWhat it grantsAdmin
Manage LabelsCreate, edit, and delete labels (tags) and label groups.yes
Manage PrioritiesCreate, edit, and delete priorities.yes
Manage FieldsManage custom fields: definitions, collections, and form groups.yes
Manage Work TypesCreate, edit, and archive item types, their statuses, and the estimate options assigned to them.yes
Manage Workspace Tab OrderReorder and toggle the tabs on each item type's detail page.yes
Manage Sidebar Field OrderReorder and toggle the sidebar fields on each item type's detail page.yes

Other

PermissionWhat it grantsAdmin
Manage CadencesCreate, edit, and archive cadences and time-boxes.yes
Manage Import HistoryView, create, and run import jobs; see import history and templates.yes

Integrations

PermissionWhat it grantsAdmin
Manage IntegrationsInstall, configure, and remove integrations.yes
Manage Database CredentialsGenerate, activate, revoke, rotate, and delete read-only database credentials.yes
Manage Identity ProvidersConfigure, verify, and remove SAML/OIDC identity providers and their email domains.yes
Manage WebhooksRegister outbound webhook endpoints, choose their events, rotate their secrets, read the delivery log and replay deliveries. Not part of any permission template.yes

Subscription

PermissionWhat it grantsAdmin
Manage Subscription TierView the workspace's plan and enrol in monthly card payments.yes
Manage Billing DetailsView and edit billing contact and address details.yes
Manage Payment MethodView and update the payment method on file.yes
Manage Billing HistoryView past invoices and billing history.yes

Admin

PermissionWhat it grantsAdmin
Manage PermissionsCreate, edit, and delete roles and their permissions. Cannot assign the Owner role.yes
Manage Lock SettingsConfigure Time Tracking: enablement, period type, grace window, and per-period overrides.yes
Manage Training SandboxesView and manage the organization's training sandboxes.yes
View Authentication LogSee who signed in to the organization, how they signed in, and sign-in problems reported by the browser (Authentication Log). Part of no template, because the log shows members' network addresses: grant it on its own. Roles that held Manage Permissions when it was introduced were given it.yes

How roles relate to sharing

Roles decide the kinds of action you can take; Sharing & Access decides which objects you can take them on. For items, workstreams, boards, and folders both are checked. Understanding Permissions walks through how they combine.