Share with Your Team

After publishing a catalog, give your colleagues read or edit access.

Invite members

  1. Click Catalog actions at the top of the left navigation panel.

  2. Click Manage access.

  3. Add users from the user list or enter an email address, then select a role:

    • Editor — writes and publishes articles in catalogs they have access to. Uses an editor seat.

    • Reader — reads catalogs without editing them. Readers are free and unlimited.

  4. If needed, enable AI agent access and grant access to catalogs right away.

The member receives an invitation email, follows the link, and signs in with Yandex or Google using the email address the invitation was sent to.

The sixth and subsequent editors require a paid plan. You can subscribe in the Billing section of the organization settings.

Set up catalog access

The Repositories section of the organization settings lists all catalogs in the space and their access permissions. For each catalog, you can assign an owner, editors, and readers. Only organization editors can be assigned the catalog editor or catalog owner role.

To show an article or catalog to a colleague, click Share: the link is copied immediately. Only an organization member with access to the catalog can open it.

Enable the AI agent

The AI agent finds answers across catalogs and writes articles. To learn how to grant members access to it and top up the balance, see How to Enable the AI Agent.

The space owner configures access to the app and documentation portal in the admin panel.

Set up access

  1. Assign licenses to editors. Only users who edit content in the app need a license. Readers and reviewers do not need one.

  2. Create groups. Groups in Gramax are easier to manage than groups in AD: you can grant them read or edit access to catalogs directly.

  3. Grant catalog access. On the Repositories tab, assign an owner, editors, and readers for each catalog, using individual users or groups. To make a catalog available to everyone who has signed in with their account, use the Authenticated group.

See Roles and Access and Catalog Display for details on roles and permissions.

Invite colleagues

Send your colleagues two addresses:

  • The browser app URL, for working in a browser.

  • The GES server URL, for signing in from the desktop app.

Your colleagues sign in to the app, load the available catalogs from the home page, make changes, and publish them.

Readers sign in to the documentation portal and see only the catalogs they have access to. Readers do not need a license.

Invite editors

  1. Give your colleagues access to the catalog's repository in your Git storage: GitHub, GitLab, or another service.

  2. They open Gramax, connect the same storage, and load the catalog.

  3. Each person publishes their changes to storage and syncs their colleagues' changes to their own copy.

Make the catalog available to readers

Readers view catalogs on a documentation portal, a website that does not require Gramax to be installed.

  1. Deploy the portal on your server using Docker.

  2. Add the catalog to the portal in the admin panel.

Other publishing options, such as a static site, are described in the Documentation Portal section.

What's next