Roles and Access
Roles and permissions determine who can manage a space, edit catalogs, and read documentation. In Cloud and Enterprise Server, permissions are assigned in Gramax. In Open Source, editing access is granted in your Git storage.
In Gramax Cloud, each member has an organization role and a role in each catalog they have access to. The organization owner and administrators can manage members and access.
Organization roles
Organization owner — has all administrator permissions and can also appoint administrators and cancel the subscription. Each organization has one owner: the person who created it. The owner is always an editor and always has access to the AI agent.
Administrator — manages organization settings, including members, catalog access, billing, and tokens. Only an editor can be an administrator.
Editor — can write and publish articles in catalogs they have access to. Uses an editor seat in the organization.
Reader — can read catalogs they have access to.
Catalog roles
Each catalog has an owner, editors, and readers:
Catalog owner — must be an editor in the organization.
Editor — writes and publishes articles in the catalog. Only organization editors can be assigned this role.
Reader — reads the catalog without being able to edit it.
Grant access
Members and their organization roles are listed in the Users section of the organization settings. See Share with Your Team for instructions on inviting colleagues.
Access to individual catalogs is configured in the Repositories section, where you assign an owner, editors, and readers for each catalog.
Sharing an article or catalog link does not grant access. Only organization members who have access to the catalog can open it.
Editor seats
Up to five editors can work for free. The sixth and subsequent editors require a subscription. Readers are free and unlimited.
Manage the subscription in the Billing section of the organization settings.
AI agent access
The owner or an administrator grants each member access to the AI agent individually, either in the AI credits section of the organization settings or when inviting them. The owner always has access.
In Gramax Enterprise Server, permissions are assigned for the space and for individual catalogs. The space owner manages users and access in the admin panel.
Space roles
Space owner — manages the space in the admin panel and can view and edit any catalog. Permissions are inherited: the space owner has catalog owner, editor, and reader permissions for all catalogs.
To assign a space owner, on the Users tab, click the edit icon next to the user and turn on the Space owner toggle in the card. The toggle is available only if the user's Editor toggle is on. You can also grant the role to a group — with the same toggle in the group card on the User groups tab.
Catalog roles
Catalog owner — changes catalog settings. This role is assigned automatically to the person who first publishes the catalog, but it can be reassigned.
Editor — loads the catalog in the app and edits its content.
Reviewer — edits articles only in the branches assigned to them, but cannot manage branches or the catalog. The role is granted automatically to every approver of a merge request for that request's branch when the author publishes the request. The space owner can also assign a reviewer manually and choose the branches. Any employee can be a reviewer, even without an editor license. Their access is revoked when the merge request is completed.
Reader — views the catalog on the documentation portal. Readers can also sign in to the app, load catalogs they have access to, and switch between branches, but they cannot publish changes: the publish button is hidden.

For the full list of permissions for each role and how licenses are assigned, see Licenses and Permissions Matrix.
Change access for several at once
On the Users, User groups, and Catalogs tabs, you can check several rows and pick the bulk-edit action from the dropdown for selected rows — a card opens where you change access or groups for all selected rows at once.
Editing access
Give your colleagues access to the catalog's repository in your Git storage: GitHub, GitLab, or another service. They connect the same storage and load the catalog in Gramax.
Reading access
Readers view catalogs on the documentation portal. To give them access, deploy a portal and add the catalog.
See Share with Your Team for step-by-step instructions.