Managing user permissions in Guru

Once a workspace Admin (or relevant custom role) invites users and organizes them into Groups, they can assign permissions for accessing and managing content in Guru. Depending on how your team uses Guru—to search, document, or share knowledge—access levels may differ.

👥

Access Requird

You must be a workspace Admin or a relevant custom role to manage access in Guru.

Assigning Access in Guru

Check out this video which demonstrates how to assign access in Guru:

Guru uses a 2-step model to manage permissions:

Roles are a collected set of permissions that provide them access to perform activities over specific objects (Pages, Collections, Sources, or Knowledge Agents)across the workspace or the workspace itself.

Users or Groups are assigned to a role across those objects.

Step 1: Starting with a Role

Roles are sets of permissions that determine what actions users can perform in Guru. They come in two types:

An Admin is a workspace-level role with full access to manage users, settings, and content across the entire workspace. A Creator can create new objects like collections and knowledge agents but has no additional permissions unless they become the owner of what they create. An Owner is an object-level role with permission to edit, share, delete, and view analytics for only the specific objects they’ve been assigned. A Viewer is also an object-level role and can only view content without the ability to modify or manage it.

  • System Roles (predefined):

    • Admin- a workspace-level role with full access to manage users, settings, and content across the entire workspace.

    • Creator - a workspace-level role that can create new objects (Knowledge Agents, Sources, Pages, Collections) but has no additional permissions unless they become the owner of what they create (which is automated).

    • Owner - an object-level role with permission to edit, share, delete, and view analytics for only the specific objects they’ve been assigned.

    • Viewer - an object-level role and can only view content without the ability to modify or manage it.

  • Custom Roles (created by Admins or other relevant custom roles):

    • Tailored sets of permissions across Guru objects.

To manage roles:

  1. Review existing roles or create new ones with the required permissions. See: Creating Custom Roles in Guru

Assigning Users to Groups (Optional)

Groups help simplify access management by letting you apply roles to multiple users at once.

  • You can assign object permissions to groups, or directly to individual users.

  • To create or manage groups, see the article: Creating and Managing Groups.


Step 2: Assigning Users/Groups to Guru Objects

You can assign roles at the workspace level or on specific objects like Knowledge Agents, Pages, or Collections. See below for the steps for each.

✍️

Note

Workspace-Level Permissions** For administrative actions like inviting users or managing workspace-wide settings.

See: Assigning Workspace-Level Permissions



Assigning Users/Groups to Knowledge Agents

  1. Go to Manage > Knowledge Agents.

  2. Select the agent, then open the Permissions tab.

  3. Click Add Owner, Viewer, or assign a Custom Role.

  4. Choose a user or group and click Save


💡

Tip

The creator of a Knowledge Agent automatically becomes its Owner.

Assigning Users/Groups to Collections

  1. Go to Manage > Collections.

  2. Select the desired Collection.

  3. Click the Permissions tab.

  4. Assign Owner, Viewer, or a Custom Role.

  5. Add users or groups and click Save.


Assigning Users/Groups to Pages

  1. Open the Page.

  2. Click … (More Options) > Manage Permissions.

  3. Add users or groups as Owner, Viewer, or assign a Custom Role.

  4. Click Save.

✍️

Note

You can also assign permissions during Page creation in the Add Collaborators step.



Assigning Users/Groups to Sources

  1. Navigate to Manage > Sources.

  2. Select a source and click … (More Options) > Manage Access.

  3. Assign Owner, Viewer, or a Custom Role.

  4. Add users or groups and click Save.


Viewing available permissions and definitions

All permissions can be reviewed in-app under Manage > Custom Roles. They are grouped by object type:

Workspace Permissions

PermissionDefinition
Manage General SettingsConfigure Workspace-wide settings, appearance, and preferences.
Create new WorkspacesSet up new Workspaces.
Create new CollectionsAdd new Collections for knowledge organization.
Manage all CollectionsConfigure settings and permissions for all Collections.
Create new PagesAdd new Pages within the Workspace.
Manage all PagesConfigure and manage all Page settings and permissions.
Create new Knowledge AgentsSet up new Knowledge Agents.
Manage all Knowledge AgentsManage Knowledge Agent settings and permissions.
Create new SourcesAdd new knowledge Sources.
Manage all SourcesConfigure and manage all knowledge Sources.
Manage Apps & IntegrationsSet up integrations (Slack, Teams, Zapier, etc.).
Manage AssistCustomize AI writing prompts.
Manage BillingControl subscription and payment settings.
Manage HRISManage HRIS integrations.
Manage SSO & SCIMConfigure SSO and SCIM provisioning.
Manage UsersInvite and manage users.
Manage RolesCreate and manage custom roles.
View Workspace AnalyticsAccess metrics on Workspace activity and performance.

Collections, Folders, and Cards Permissions

PermissionDefinition
View contentAccess Cards and folders.
Manage Collection settingsEdit Collection attributes.
Manage Collection permissionsControl who can access the Collection.
Manage Collection templatesCreate and manage Card templates.
Delete CollectionsPermanently remove a Collection.
Create Card draftsStart draft Cards.
Publish CardsPublish or update Cards.
Archive CardsArchive Cards in the Collection.
Delete CardsPermanently remove Cards.
Manage Card settingsUpdate Card details and verification.
Manage Card permissionsSet Card visibility and access.
Verify CardsMark Cards as verified.
Unverify CardsRemove Card verification.
Comment on CardsParticipate in discussions.
Send Card AnnouncementsSend updates via Cards.
Manage tags and tag categoriesOrganize tags and categories.
Create foldersAdd new folders.
Delete foldersRemove folders (contents moved to parent).
Manage folder settingsEdit folder attributes.
Manage folder permissionsControl folder access.
View User AnalyticsReview user activity.
View Author AnalyticsSee author contributions.
View Card AnalyticsAnalyze Card performance.

Knowledge Agent Permissions

PermissionDefinition
View AgentAccess the Knowledge Agent.
Manage Agent PermissionsSet visibility and access.
Manage Agent SettingsEdit Agent behavior and training.
Delete AgentPermanently delete the Agent.
Manage questions asked of the agentReview questions in AI Training Center.
View agent analyticsMonitor Agent performance.

Page Permissions

PermissionDefinition
View pageAccess Page content.
Edit pageModify Page structure or content.
Manage page permissionsControl who can view or edit.
Delete pagePermanently delete the Page.

Source Permissions

PermissionDefinition
View sourceAccess the Source and referenced content.
Manage sourceConfigure Source settings.
Delete sourcePermanently remove the Source.

👀

Want a closer look at some key Guru features and best practices?

Check out our events page for demos, workshops, new release roundups, Getting Started bootcamp, guest panelists and more! For upcoming live events and a series of past recordings: Click here to register