From e2da10e79c511fad349d8d18f8e1266a0182cc41 Mon Sep 17 00:00:00 2001 From: Hannes Lenke Date: Mon, 2 Nov 2026 17:23:21 -0500 Subject: [PATCH 1/2] docs(admin): merge the role tables into one 3-column table The built-in roles are strictly hierarchical, so the 6-column capability matrix carried one fact per row: the lowest role that can do it. Fold it into the "Choosing the right role" table as one row per role with what it adds and who it suits, keeping every capability. The page no longer needs wide mode, so it gets its "On this page" panel back. Co-Authored-By: Claude Opus 5.5 --- admin/team-management/overview.mdx | 34 ++++++++---------------------- 1 file changed, 9 insertions(+), 25 deletions(-) diff --git a/admin/team-management/overview.mdx b/admin/team-management/overview.mdx index a7c248f3..d7fa37e6 100644 --- a/admin/team-management/overview.mdx +++ b/admin/team-management/overview.mdx @@ -3,7 +3,6 @@ title: "Admin Overview" description: "Comprehensive guide to managing your Checkly account, team members, security, and integrations" sidebarTitle: "Overview" canonical: 'https://www.checklyhq.com/docs/admin/team-management/overview/' -mode: "wide" --- This section covers all aspects of administering your Checkly account, from managing team members and permissions to setting up advanced security features and API access. @@ -14,35 +13,20 @@ Checkly has five built-in roles: **Owner**, **Admin**, **Read & Write**, **Read Each account has one Owner. The account creator is the Owner until they [transfer ownership](#transferring-ownership). You can invite teammates with any other role. You can [change a member's role](/admin/team-management/managing-team-members#change-members’-roles) after they join. -| Capability | Owner | Admin | Read & Write | Read & Run | Read Only | -|------------|:-----:|:-----:|:------------:|:----------:|:---------:| -| View all resources | ✓ | ✓ | ✓ | ✓ | ✓ | -| Trigger checks and tests | ✓ | ✓ | ✓ | ✓ | ✗ | -| Create/edit/delete checks | ✓ | ✓ | ✓ | ✗ | ✗ | -| Manage alert settings | ✓ | ✓ | ✓ | ✗ | ✗ | -| Manage maintenance windows | ✓ | ✓ | ✓ | ✗ | ✗ | -| Share/edit/delete shared views | ✓ | ✓ | ✓ | ✗ | ✗ | -| Access locked variables | ✓ | ✓ | ✓ | ✗ | ✗ | -| Manage team members (only below their current role. i.e. Owners can remove Admins, but Admins cannot remove Owners or other Admins.) | ✓ | ✓ | ✗ | ✗ | ✗ | -| Manage account settings | ✓ | ✓ | ✗ | ✗ | ✗ | -| Manage private locations | ✓ | ✓ | ✗ | ✗ | ✗ | -| Create service API keys | ✓ | ✓ | ✗ | ✗ | ✗ | -| Transfer ownership | ✓ | ✗ | ✗ | ✗ | ✗ | +| Role | Adds to the role above | Best for | +|------|------------------------|----------| +| **Read Only** | View all resources | Stakeholders who need visibility into monitoring status | +| **Read & Run** | Trigger checks and tests | QA engineers or CI/CD pipelines that run tests but shouldn't modify configuration | +| **Read & Write** | Create, edit, and delete checks
Manage alert settings and maintenance windows
Share, edit, and delete shared views
Access locked variables | Developers who create and maintain checks | +| **Admin** | Manage team members
Manage account settings and private locations
Create service API keys | Team leads who manage members, settings, and infrastructure | +| **Owner** | Transfer ownership | Account creator with full control over billing and ownership | + +Admins and Owners can only manage members below their own role. For example, an Owner can remove an Admin, but an Admin can't remove an Owner or another Admin. ### Permissions and roles Your account role grants permissions for actions on resources. Use the [permissions reference](/admin/team-management/permissions) to find each permission’s ID, name in the role editor, description, and how to request access. -### Choosing the Right Role - -| Role | Best for | -|------|----------| -| **Owner** | Account creator with full control over billing and ownership | -| **Admin** | Team leads who manage members, settings, and infrastructure | -| **Read & Write** | Developers who create and maintain checks | -| **Read & Run** | QA engineers or CI/CD pipelines that run tests but shouldn't modify configuration | -| **Read Only** | Stakeholders who need visibility into monitoring status | - ### Adding Team Members Learn how to invite new users to your account. From d9f91dcd1cfe312999937398e113db646a676d51 Mon Sep 17 00:00:00 2001 From: Hannes Lenke Date: Mon, 2 Nov 2026 17:28:41 -0500 Subject: [PATCH 2/2] docs(admin): keep the role matrix and let its cells shrink Go back to the original capability matrix and drop the merged 3-column table. Wrap the matrix in a role-matrix div and override Mintlify's 150px cell minimum for that table only, so it fits next to the "On this page" panel without wide mode. Co-Authored-By: Claude Opus 5.5 --- admin/team-management/overview.mdx | 37 ++++++++++++++++++++++-------- style.css | 7 ++++++ 2 files changed, 35 insertions(+), 9 deletions(-) diff --git a/admin/team-management/overview.mdx b/admin/team-management/overview.mdx index d7fa37e6..4a53f4dc 100644 --- a/admin/team-management/overview.mdx +++ b/admin/team-management/overview.mdx @@ -13,20 +13,39 @@ Checkly has five built-in roles: **Owner**, **Admin**, **Read & Write**, **Read Each account has one Owner. The account creator is the Owner until they [transfer ownership](#transferring-ownership). You can invite teammates with any other role. You can [change a member's role](/admin/team-management/managing-team-members#change-members’-roles) after they join. -| Role | Adds to the role above | Best for | -|------|------------------------|----------| -| **Read Only** | View all resources | Stakeholders who need visibility into monitoring status | -| **Read & Run** | Trigger checks and tests | QA engineers or CI/CD pipelines that run tests but shouldn't modify configuration | -| **Read & Write** | Create, edit, and delete checks
Manage alert settings and maintenance windows
Share, edit, and delete shared views
Access locked variables | Developers who create and maintain checks | -| **Admin** | Manage team members
Manage account settings and private locations
Create service API keys | Team leads who manage members, settings, and infrastructure | -| **Owner** | Transfer ownership | Account creator with full control over billing and ownership | - -Admins and Owners can only manage members below their own role. For example, an Owner can remove an Admin, but an Admin can't remove an Owner or another Admin. +
+ +| Capability | Owner | Admin | Read & Write | Read & Run | Read Only | +|------------|:-----:|:-----:|:------------:|:----------:|:---------:| +| View all resources | ✓ | ✓ | ✓ | ✓ | ✓ | +| Trigger checks and tests | ✓ | ✓ | ✓ | ✓ | ✗ | +| Create/edit/delete checks | ✓ | ✓ | ✓ | ✗ | ✗ | +| Manage alert settings | ✓ | ✓ | ✓ | ✗ | ✗ | +| Manage maintenance windows | ✓ | ✓ | ✓ | ✗ | ✗ | +| Share/edit/delete shared views | ✓ | ✓ | ✓ | ✗ | ✗ | +| Access locked variables | ✓ | ✓ | ✓ | ✗ | ✗ | +| Manage team members (only below their current role. i.e. Owners can remove Admins, but Admins cannot remove Owners or other Admins.) | ✓ | ✓ | ✗ | ✗ | ✗ | +| Manage account settings | ✓ | ✓ | ✗ | ✗ | ✗ | +| Manage private locations | ✓ | ✓ | ✗ | ✗ | ✗ | +| Create service API keys | ✓ | ✓ | ✗ | ✗ | ✗ | +| Transfer ownership | ✓ | ✗ | ✗ | ✗ | ✗ | + +
### Permissions and roles Your account role grants permissions for actions on resources. Use the [permissions reference](/admin/team-management/permissions) to find each permission’s ID, name in the role editor, description, and how to request access. +### Choosing the Right Role + +| Role | Best for | +|------|----------| +| **Owner** | Account creator with full control over billing and ownership | +| **Admin** | Team leads who manage members, settings, and infrastructure | +| **Read & Write** | Developers who create and maintain checks | +| **Read & Run** | QA engineers or CI/CD pipelines that run tests but shouldn't modify configuration | +| **Read Only** | Stakeholders who need visibility into monitoring status | + ### Adding Team Members Learn how to invite new users to your account. diff --git a/style.css b/style.css index 7849b3cd..844f4c08 100644 --- a/style.css +++ b/style.css @@ -527,3 +527,10 @@ header button[aria-label="More actions"]::after { height: 8rem; } } + +/* Role matrix on admin/team-management/overview. Mintlify gives every table + cell min-width: 150px, which makes this 6-column table wider than the + content column next to the "On this page" panel. Let its cells shrink. */ +.role-matrix table td { + min-width: 0; +}