Roles and permissions

Control who can edit content, manage settings, and administer your Mintlify project.

Mintlify projects use two built-in roles. All access is scoped to a single project — roles from one project don’t carry over to others.

Built-in roles

Admin

Full access to project settings, billing, deployments, and member management. Can use the web editor and the dashboard.

Editor

Can create, edit, and publish pages using the web editor. Cannot access project settings, billing, or deployment configuration.

What each role can do

Action	Admin	Editor
Edit and publish pages	✓	✓
Manage navigation and docs.json	✓	—
Invite or remove members	✓	—
Configure custom domain	✓	—
Manage billing and plan	✓	—
View deployment history	✓	—

Git-based access

Roles in the Mintlify dashboard are separate from GitHub (or GitLab) repository permissions. Anyone with write access to your repository can push changes that trigger a deployment, regardless of their Mintlify role.

For organizations that want to restrict who can deploy, use GitHub branch protection rules to require pull request reviews before changes merge to your default branch.

Organization-level access

If your Mintlify organization has multiple projects, admins can be granted access at the organization level to manage settings and members across all projects from a single place. Project-level roles still control what each person can do within a specific project.