Roles and permissions

Mintlify uses two roles at the organization level and the same two roles at the project level. Project-level roles take precedence within that project.

Organization roles

Role	What they can do
Admin	Full access to all projects, organization settings, billing, and member management.
Editor	Can create, edit, and publish pages in any project they’re a member of. Cannot access billing or organization settings.

Project roles

Each project has its own member list. A person can be an Admin in one project and an Editor in another.

Role	What they can do
Admin	Full access to project settings, custom domain configuration, and member management for that project.
Editor	Can write and publish pages using the web editor. Cannot change project settings.

The web editor vs Git

Editors who use the web editor work within Mintlify — no Git knowledge required. Anyone with write access to the underlying Git repository can also make changes via Git and the CLI, regardless of their Mintlify role. If you want to restrict who can deploy changes, use branch protection rules in GitHub or GitLab to require pull request reviews before merges to your default branch.

Auditing

Admins can view a log of membership changes in Settings → Audit log (available on Enterprise plans). Review access quarterly when team members change roles or leave the organization.

​Organization roles

​Project roles

​The web editor vs Git

​Auditing

Organization roles

Project roles

The web editor vs Git

Auditing