diff --git a/content/docs/dashboard/dashboard-settings/overview-settings-team.mdx b/content/docs/dashboard/dashboard-settings/overview-settings-team.mdx
index d1e7e9f8..d93a375c 100644
--- a/content/docs/dashboard/dashboard-settings/overview-settings-team.mdx
+++ b/content/docs/dashboard/dashboard-settings/overview-settings-team.mdx
@@ -20,6 +20,46 @@ From there, fill out the details (name and email address) and **click** the **In
 
 Once the user accepts the invite, they'll show up in your Team section. You can add or remove team members at anytime. To remove a team member, **click** the **trashcan** icon under **Actions**.
 
+### Team roles
+
+Only **Owners** or **Admins** can change team member roles.
+
+#### Owner — Full control
+
+- Can perform all actions on the team/organization
+- Can invite/remove team members
+- Can assign or change any team member's role including other Owners
+- Can modify billing and organization settings
+- Access to all features including sensitive data (webhooks, API keys)
+- Maximum privileges
+
+#### Admin — Full access, limited team management
+
+- Can perform most administrative actions
+- Can invite/remove team members
+- Cannot assign or change Owner roles (can only assign Admin, Editor, or Reader)
+- Access to sensitive features like webhook destinations
+- Full create/update/delete permissions on paywalls, campaigns, products, etc.
+
+#### Editor — Can create and modify content
+
+- Can read, create, and update:
+  - Paywalls and paywall triggers
+  - Campaigns and A/B tests
+  - Products
+  - Notifications
+  - Projects
+- Can view applications and organizations
+- Cannot delete applications
+- Cannot access team management (invite/remove members)
+- Cannot access sensitive settings like webhooks or billing
+
+#### Reader — View-only access
+
+- Can view/read all resources (paywalls, campaigns, analytics, etc.)
+- Cannot create, update, or delete anything
+- Useful for stakeholders who need visibility but shouldn't make changes
+
 ### Renaming your team
 
 To rename your team, enter in a new value name under the **Team Name** section, and **click** the **Save** button: