Orion has three tenant-level roles you can assign: Admin, Analyst, and Viewer. They control baseline permissions. Admins invite users, assign roles, and manage group membership from Admin Settings → Users. Users and Groups are managed from the same page.
Accessing User Management
User Management is available to tenant Admins and to Group Admins. To access it:
Click Admin Settings in the left-hand navigation menu
Select Users in the Admin Settings sidebar
The Manage Users page has two tabs: Users (everyone in the tenant) and Groups (groups of users that share access to projects, data, and knowledge).
Tenant users and their access
Use the search box to filter by name, email, role, or project. The Role and Project Access columns on each row are controls: both change what that user can reach.
Inviting New Users
To invite a new team member to your Orion tenant:
Navigate to Admin Settings → Users
From the Users tab, click Add User
Enter the new user’s email address
Choose the appropriate role
For an Analyst or Viewer, optionally pick projects in the Project access step and groups in the Group assignment step
Click Send invite
An Admin invite skips the Project access and Group assignment steps, because a tenant Admin already has full-tenant scope. The Group assignment step appears only when the tenant has groups.The new user will receive an email with instructions to complete their account setup. See User Onboarding & Invitations for more details.Group Admins can also invite. Their invitees always get the Viewer tenant role, must join at least one group the Group Admin administers, and can only be added to projects the Group Admin administers.
To onboard a new user directly into a group, invite them from inside that
group instead. Open the group, click Add member, then Invite by email
and the invitee is automatically added to the group with the role you pick on
first login. See
Groups for
details.
Tenant Roles
Every user has a tenant role that defines their baseline permissions across the entire tenant.
Admin
Full control of the tenant. Can invite users, create and manage groups,
connect data sources, and assign users to projects.
Analyst
Can do just about anything within a project: chat, run analyses, and share
projects. Cannot add existing users to other projects directly.
Viewer
Read-only access to approved projects and content. Cannot run analyses or
make changes.
Carefully consider permission levels when inviting users, especially for
administrative roles.
Tenant roles vs. group roles
If you use Groups, each user also has a group role in every group they belong to (Group Admin, Group Analyst, or Group Viewer). Group roles are independent of tenant roles and only apply inside that group, so a tenant Viewer can still be a Group Admin in a group they manage.For a side-by-side comparison of all six roles, see Groups → Roles at a Glance.
Changing a User’s Tenant Role
Pick the new role in the Role select on the user’s row, then confirm. Each role is described under Tenant Roles. Admin is the consequential direction: an Admin reaches every project, every group, and tenant-wide settings.Only Tenant Admins can change a role. A Group Admin sees a read-only badge in that column instead. Nobody changes their own role, Tenant Admins included: ask another Tenant Admin.The column can also read Visitor, a role SSO assigns and nobody assigns here. You can move a Visitor to Admin, Analyst, or Viewer. The select does not offer Visitor, so the move is one way. See Portal visitor domains for what a Visitor can reach.
Project Access and Group Membership
Click the count in the Project Access column to open Manage Projects. Check a project to grant direct access, clear one to revoke it, then click Save Changes. Only Tenant Admins can save here: the save fails for a Group Admin.This grants and revokes direct access only. Clearing every box still leaves the user the projects their groups carry, so change their group membership for those. See How users get access to a project.The Groups column names the groups a user belongs to, and does not set their role in any of them. Group roles are changed on the group’s own Members tab.
Deactivating a User
Deactivation removes a user’s access and keeps their history. Open the three-dot menu on the user’s row and select Set as Inactive. Set as Active restores access.To see Orion as another user without changing their access, Sudo as a user instead.
Best Practices
Follow the principle of least privilege: grant users the minimum permissions
they need to do their job. For tenants using Groups, prefer group membership
over direct project access: it’s easier to audit and easier to revoke when
someone’s role changes.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Orion Public Docs","description":"Documentation for Orion, the collaborative analytics platform built by Gravity (bygravity.com). Learn how to connect data sources, run analyses in natural language, build shared Context, and turn insights into dashboards, reports, and scheduled workflows.","colors":{"primary":"#0d9488","light":"#14b8a6","dark":"#134e4a"},"logo":{"light":"https://mintcdn.com/gravity-8db392ea/M5QrrLg7uEV27J6q/logo/orion-logo-charcoal.svg?fit=max\u0026auto=format\u0026n=M5QrrLg7uEV27J6q\u0026q=85\u0026s=4e64d863f48c2a81bdbbea46b631b952","dark":"https://mintcdn.com/gravity-8db392ea/M5QrrLg7uEV27J6q/logo/orion-logo-dark.svg?fit=max\u0026auto=format\u0026n=M5QrrLg7uEV27J6q\u0026q=85\u0026s=fb58ab7b667aad66b5b5b0a9839da9dc"},"favicon":"https://mintcdn.com/gravity-8db392ea/4asdrY4OKG8YwKh8/favicon.svg?fit=max\u0026auto=format\u0026n=4asdrY4OKG8YwKh8\u0026q=85\u0026s=54889911a86c33fc393a262d1e8c9075","navbar":{"links":[{"href":"mailto:help@bygravity.com","label":"Support"}],"primary":{"type":"button","label":"Website","href":"https://bygravity.com"}},"footer":{"socials":{"x":"https://x.com/OrionByGravity","linkedin":"https://linkedin.com/company/gravity-foundation"}},"seo":{"organization":{"name":"Gravity","url":"https://bygravity.com","logo":"https://bygravity.com/gravity-logo.svg"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"metadata":{"timestamp":false},"markdown":{"instructions":"Orion is a collaborative analytics platform built by Gravity (bygravity.com). It connects to data warehouses, to Looker and dbt for existing business logic, and to a small set of external-context sources, and it lets teams ask questions in natural language to get shared analyses, dashboards, reports, and slide decks. The Connecting Data Sources page is the authoritative list of supported sources. When referencing Orion features, always link to the relevant documentation page. Orion is not open-source; it is a commercial SaaS product accessed at runorion.com."},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://bygravity.com"},{"anchor":"Blog","icon":"newspaper","href":"https://bygravity.com/resources"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"gravity-8db392ea","hasAudioNarration":false,"actualSubdomain":"gravity-8db392ea","customDomains":["docs.runorion.com"],"gitSource":{"type":"github","owner":"gravity-foundation","repo":"orion-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6b009fe35f38e5228b383878","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Docs","count":63},{"language":"default","tag":"Chat","count":11},{"language":"default","tag":"Core Concepts","count":8},{"language":"default","tag":"Configuration","count":7},{"language":"default","tag":"Dashboards","count":6},{"language":"default","tag":"Context","count":5},{"language":"default","tag":"MCP Server","count":5},{"language":"default","tag":"Version Control","count":5},{"language":"default","tag":"Workflows","count":5},{"language":"default","tag":"Profile \u0026 Settings","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"page-status.css","content":"body:has([data-page-status=\"beta\"]) #page-title::before{content:\"Beta\";display:inline-block;vertical-align:middle;margin-right:0.75rem;padding:0.125rem 0.5rem;border:1px solid rgba(13, 148, 136, 0.25);border-radius:0.375rem;background:rgba(13, 148, 136, 0.08);color:#0f766e;font-size:0.75rem;font-weight:600;line-height:1.25rem;letter-spacing:0;transform:translateY(-0.15rem)}html.dark body:has([data-page-status=\"beta\"]) #page-title::before{border-color:rgba(45, 212, 191, 0.25);background:rgba(45, 212, 191, 0.08);color:#5eead4}"}]}
{"page":{"pagePath":"configuration/user-management","slug":"/configuration/user-management","pageMetadata":{"title":"User Management","description":"Invite people and set what they can reach","icon":"users","href":"/configuration/user-management"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Invite people and set what they can reach\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Card,CardGroup,Frame,Heading,OptimizedImage,Tip,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Orion has three tenant-level roles you can assign: Admin, Analyst, and Viewer. They control baseline permissions. Admins invite users, assign roles, and manage group membership from `,_jsx(_components.strong,{children:`Admin Settings → Users`}),`. Users and `,_jsx(_components.a,{href:`/configuration/groups`,children:`Groups`}),` are managed from the same page.`]}),`\n`,_jsx(Heading,{level:`2`,id:`accessing-user-management`,children:`Accessing User Management`}),`\n`,_jsx(_components.p,{children:`User Management is available to tenant Admins and to Group Admins. To access it:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Admin Settings`}),` in the left-hand navigation menu`]}),`\n`,_jsxs(_components.li,{children:[`Select `,_jsx(_components.strong,{children:`Users`}),` in the `,_jsx(_components.strong,{children:`Admin Settings`}),` sidebar`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Manage Users`}),` page has two tabs: `,_jsx(_components.strong,{children:`Users`}),` (everyone in the tenant) and `,_jsx(_components.strong,{children:`Groups`}),` (groups of users that share access to projects, data, and knowledge).`]}),`\n`,_jsx(Frame,{caption:`Tenant users and their access`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gravity-8db392ea/QDELYG7K2AKjCFHf/images/groups/users-tab.webp?fit=max\u0026auto=format\u0026n=QDELYG7K2AKjCFHf\u0026q=85\u0026s=fcb6894e6a6fdb38b978e5d2a5da98c3`,alt:`Manage Users page in Admin Settings on the Users tab, with a search box, Add User, and a table of five users with Role, Project Access, and Groups columns`,\"data-og-width\":`4800`,width:`4800`,\"data-og-height\":`3000`,height:`3000`,\"data-path\":`images/groups/users-tab.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gravity-8db392ea/QDELYG7K2AKjCFHf/images/groups/users-tab.webp?w=280\u0026fit=max\u0026auto=format\u0026n=QDELYG7K2AKjCFHf\u0026q=85\u0026s=ca2a9fdb30ea3587ffcf6af3b2d52f98 280w, https://mintcdn.com/gravity-8db392ea/QDELYG7K2AKjCFHf/images/groups/users-tab.webp?w=560\u0026fit=max\u0026auto=format\u0026n=QDELYG7K2AKjCFHf\u0026q=85\u0026s=08f202701fb50ce121a62db12ab94cb1 560w, https://mintcdn.com/gravity-8db392ea/QDELYG7K2AKjCFHf/images/groups/users-tab.webp?w=840\u0026fit=max\u0026auto=format\u0026n=QDELYG7K2AKjCFHf\u0026q=85\u0026s=0c2bc79233350df77dde57a39534abc0 840w, https://mintcdn.com/gravity-8db392ea/QDELYG7K2AKjCFHf/images/groups/users-tab.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=QDELYG7K2AKjCFHf\u0026q=85\u0026s=65880ef82bde389c942f289d9634d4e1 1100w, https://mintcdn.com/gravity-8db392ea/QDELYG7K2AKjCFHf/images/groups/users-tab.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=QDELYG7K2AKjCFHf\u0026q=85\u0026s=35c87ede334e56187b537ec9254013fb 1650w, https://mintcdn.com/gravity-8db392ea/QDELYG7K2AKjCFHf/images/groups/users-tab.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=QDELYG7K2AKjCFHf\u0026q=85\u0026s=f34bac5da6c78cd54413b3fd596c72d4 2500w`})}),`\n`,_jsxs(_components.p,{children:[`Use the search box to filter by name, email, role, or project. The `,_jsx(_components.strong,{children:`Role`}),` and `,_jsx(_components.strong,{children:`Project Access`}),` columns on each row are controls: both change what that user can reach.`]}),`\n`,_jsx(Heading,{level:`2`,id:`inviting-new-users`,children:`Inviting New Users`}),`\n`,_jsx(_components.p,{children:`To invite a new team member to your Orion tenant:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Navigate to `,_jsx(_components.strong,{children:`Admin Settings → Users`})]}),`\n`,_jsxs(_components.li,{children:[`From the `,_jsx(_components.strong,{children:`Users`}),` tab, click `,_jsx(_components.strong,{children:`Add User`})]}),`\n`,_jsx(_components.li,{children:`Enter the new user’s email address`}),`\n`,_jsx(_components.li,{children:`Choose the appropriate role`}),`\n`,_jsxs(_components.li,{children:[`For an Analyst or Viewer, optionally pick projects in the `,_jsx(_components.strong,{children:`Project access`}),` step and groups in the `,_jsx(_components.strong,{children:`Group assignment`}),` step`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Send invite`})]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`An Admin invite skips the `,_jsx(_components.strong,{children:`Project access`}),` and `,_jsx(_components.strong,{children:`Group assignment`}),` steps, because a tenant Admin already has full-tenant scope. The `,_jsx(_components.strong,{children:`Group assignment`}),` step appears only when the tenant has groups.`]}),`\n`,_jsxs(_components.p,{children:[`The new user will receive an email with instructions to complete their account setup. See `,_jsx(_components.a,{href:`/profile-settings/user-onboarding`,children:`User Onboarding \u0026 Invitations`}),` for more details.`]}),`\n`,_jsx(_components.p,{children:`Group Admins can also invite. Their invitees always get the Viewer tenant role, must join at least one group the Group Admin administers, and can only be added to projects the Group Admin administers.`}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`To onboard a new user `,_jsx(_components.strong,{children:`directly into a group`}),`, invite them from inside that\ngroup instead. Open the group, click `,_jsx(_components.strong,{children:`Add member`}),`, then `,_jsx(_components.strong,{children:`Invite by email`}),`\nand the invitee is automatically added to the group with the role you pick on\nfirst login. See\n`,_jsx(_components.a,{href:`/configuration/groups#inviting-new-users-directly-into-a-group`,children:`Groups`}),` for\ndetails.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`tenant-roles`,children:`Tenant Roles`}),`\n`,_jsx(_components.p,{children:`Every user has a tenant role that defines their baseline permissions across the entire tenant.`}),`\n`,_jsxs(CardGroup,{cols:3,children:[_jsx(Card,{title:`Admin`,icon:`shield`,children:_jsx(_components.p,{children:`Full control of the tenant. Can invite users, create and manage groups,\nconnect data sources, and assign users to projects.`})}),_jsx(Card,{title:`Analyst`,icon:`user`,children:_jsx(_components.p,{children:`Can do just about anything within a project: chat, run analyses, and share\nprojects. Cannot add existing users to other projects directly.`})}),_jsx(Card,{title:`Viewer`,icon:`eye`,children:_jsx(_components.p,{children:`Read-only access to approved projects and content. Cannot run analyses or\nmake changes.`})})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Carefully consider permission levels when inviting users, especially for\nadministrative roles.`})}),`\n`,_jsx(Heading,{level:`3`,id:`tenant-roles-vs-group-roles`,children:`Tenant roles vs. group roles`}),`\n`,_jsxs(_components.p,{children:[`If you use `,_jsx(_components.a,{href:`/configuration/groups`,children:`Groups`}),`, each user also has a `,_jsx(_components.strong,{children:`group role`}),` in every group they belong to (Group Admin, Group Analyst, or Group Viewer). Group roles are independent of tenant roles and only apply inside that group, so a tenant Viewer can still be a Group Admin in a group they manage.`]}),`\n`,_jsxs(_components.p,{children:[`For a side-by-side comparison of all six roles, see `,_jsx(_components.a,{href:`/configuration/groups#roles-at-a-glance`,children:`Groups → Roles at a Glance`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`changing-a-user’s-tenant-role`,children:`Changing a User’s Tenant Role`}),`\n`,_jsxs(_components.p,{children:[`Pick the new role in the `,_jsx(_components.strong,{children:`Role`}),` select on the user’s row, then confirm. Each role is described under `,_jsx(_components.a,{href:`#tenant-roles`,children:`Tenant Roles`}),`. Admin is the consequential direction: an Admin reaches every project, every group, and tenant-wide settings.`]}),`\n`,_jsxs(_components.p,{children:[`Only Tenant Admins can change a role. A `,_jsx(_components.a,{href:`/configuration/groups#roles-at-a-glance`,children:`Group Admin`}),` sees a read-only badge in that column instead. Nobody changes their own role, Tenant Admins included: ask another Tenant Admin.`]}),`\n`,_jsxs(_components.p,{children:[`The column can also read `,_jsx(_components.strong,{children:`Visitor`}),`, a role SSO assigns and nobody assigns here. You can move a Visitor to Admin, Analyst, or Viewer. The select does not offer Visitor, so the move is one way. See `,_jsx(_components.a,{href:`/configuration/sso#portal-visitor-domains`,children:`Portal visitor domains`}),` for what a Visitor can reach.`]}),`\n`,_jsx(Heading,{level:`2`,id:`project-access-and-group-membership`,children:`Project Access and Group Membership`}),`\n`,_jsxs(_components.p,{children:[`Click the count in the `,_jsx(_components.strong,{children:`Project Access`}),` column to open `,_jsx(_components.strong,{children:`Manage Projects`}),`. Check a project to grant direct access, clear one to revoke it, then click `,_jsx(_components.strong,{children:`Save Changes`}),`. Only Tenant Admins can save here: the save fails for a Group Admin.`]}),`\n`,_jsxs(_components.p,{children:[`This grants and revokes direct access only. Clearing every box still leaves the user the projects their groups carry, so change their group membership for those. See `,_jsx(_components.a,{href:`/configuration/groups#how-users-get-access-to-a-project`,children:`How users get access to a project`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Groups`}),` column names the groups a user belongs to, and does not set their role in any of them. Group roles are changed on the group’s own `,_jsx(_components.a,{href:`/configuration/groups#members`,children:`Members`}),` tab.`]}),`\n`,_jsx(Heading,{level:`2`,id:`deactivating-a-user`,children:`Deactivating a User`}),`\n`,_jsxs(_components.p,{children:[`Deactivation removes a user’s access and keeps their history. Open the three-dot menu on the user’s row and select `,_jsx(_components.strong,{children:`Set as Inactive`}),`. `,_jsx(_components.strong,{children:`Set as Active`}),` restores access.`]}),`\n`,_jsxs(_components.p,{children:[`To see Orion as another user without changing their access, `,_jsx(_components.a,{href:`/configuration/sudo`,children:`Sudo as a user`}),` instead.`]}),`\n`,_jsx(Heading,{level:`2`,id:`best-practices`,children:`Best Practices`}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Follow the principle of least privilege: grant users the minimum permissions\nthey need to do their job. For tenants using Groups, prefer group membership\nover direct project access: it’s easier to audit and easier to revoke when\nsomeone’s role changes.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"User Management","description":"Invite people and set what they can reach","icon":"users","href":"/configuration/user-management"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Accessing User Management","slug":"accessing-user-management","depth":2,"children":[]},{"title":"Inviting New Users","slug":"inviting-new-users","depth":2,"children":[]},{"title":"Tenant Roles","slug":"tenant-roles","depth":2,"children":[{"title":"Tenant roles vs. group roles","slug":"tenant-roles-vs-group-roles","depth":3,"children":[]}]},{"title":"Changing a User’s Tenant Role","slug":"changing-a-user’s-tenant-role","depth":2,"children":[]},{"title":"Project Access and Group Membership","slug":"project-access-and-group-membership","depth":2,"children":[]},{"title":"Deactivating a User","slug":"deactivating-a-user","depth":2,"children":[]},{"title":"Best Practices","slug":"best-practices","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"gravity-8db392ea","siteName":"Orion Public Docs","title":"User Management - Orion Public Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T15:25:44.628Z","originalFileLocation":"configuration/user-management.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Invite people and set what they can reach\">\u003cmeta data-mint-head name=\"application-name\" content=\"Orion Public Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gravity-8db392ea/UtPVDZ47XLdW1r-w/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/gravity-8db392ea/UtPVDZ47XLdW1r-w/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gravity-8db392ea/UtPVDZ47XLdW1r-w/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/gravity-8db392ea/UtPVDZ47XLdW1r-w/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/gravity-8db392ea/UtPVDZ47XLdW1r-w/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gravity-8db392ea/UtPVDZ47XLdW1r-w/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gravity-8db392ea/UtPVDZ47XLdW1r-w/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/gravity-8db392ea/UtPVDZ47XLdW1r-w/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/gravity-8db392ea/UtPVDZ47XLdW1r-w/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"User Management - Orion Public Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Invite people and set what they can reach\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Orion Public Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.runorion.com/configuration/user-management\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://gravity-8db392ea.mintlify.site/_mintlify/api/og/v2?division=Configuration\u0026amp;title=User+Management\u0026amp;description=Invite+people+and+set+what+they+can+reach\u0026amp;theme=196978094e3352db22f3232d\u0026amp;signature=abb738c31ce4876514ee653f2d87475cc5e5256fc068ee58bc6da3ccc3af0366\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"User Management - Orion Public Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Invite people and set what they can reach\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gravity-8db392ea.mintlify.site/_mintlify/api/og/v2?division=Configuration\u0026amp;title=User+Management\u0026amp;description=Invite+people+and+set+what+they+can+reach\u0026amp;theme=196978094e3352db22f3232d\u0026amp;signature=abb738c31ce4876514ee653f2d87475cc5e5256fc068ee58bc6da3ccc3af0366\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/gravity-8db392ea/UtPVDZ47XLdW1r-w/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Orion Public Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0d9488\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.runorion.com/configuration/user-management\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/configuration/user-management.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://bygravity.com/#organization\",\"name\":\"Gravity\",\"url\":\"https://bygravity.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://bygravity.com/gravity-logo.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.runorion.com#website\",\"name\":\"Orion Public Docs\",\"url\":\"https://docs.runorion.com\",\"publisher\":{\"@id\":\"https://bygravity.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.runorion.com/configuration/user-management#webpage\",\"url\":\"https://docs.runorion.com/configuration/user-management\",\"name\":\"User Management\",\"description\":\"Invite people and set what they can reach\",\"dateModified\":\"2026-11-16T15:25:44.628Z\",\"isPartOf\":{\"@id\":\"https://docs.runorion.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.runorion.com/configuration/user-management#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.runorion.com/configuration/user-management#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Configuration\",\"item\":\"https://docs.runorion.com/configuration/global-configuration\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"User Management\",\"item\":\"https://docs.runorion.com/configuration/user-management\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.runorion.com/configuration/user-management#article\",\"headline\":\"User Management\",\"name\":\"User Management\",\"description\":\"Invite people and set what they can reach\",\"url\":\"https://docs.runorion.com/configuration/user-management\",\"mainEntityOfPage\":{\"@id\":\"https://docs.runorion.com/configuration/user-management#webpage\"},\"dateModified\":\"2026-11-16T15:25:44.628Z\",\"publisher\":{\"@id\":\"https://bygravity.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.runorion.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Orion Public Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Gravity\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/configuration/user-management.md","siteName":"Orion Public Docs","nav":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://bygravity.com"},{"anchor":"Blog","icon":"newspaper","href":"https://bygravity.com/resources"}]},"tabs":[{"tab":"Docs","groups":[{"group":"Getting Started","pages":[{"title":"Welcome to Orion","icon":"compass","href":""},{"title":"Quickstart","icon":"rocket","href":"/quickstart"}]},{"group":"Data Sources","pages":[{"title":"Data Sources Management","icon":"database","href":"/configuration/data-sources"},{"title":"Connecting Data Sources","icon":"plug","href":"/connecting-data-sources"}]},{"group":"Core Concepts","pages":[{"title":"Projects","icon":"folder","href":"/core-concepts/projects"},{"title":"Warp Drive","icon":"bolt","href":"/core-concepts/warp-drive"},{"title":"Context","icon":"book-open","href":"/core-concepts/knowledge-base"},{"title":"Structured Context","icon":"table-list","href":"/core-concepts/structured-context"},{"title":"Workflows","icon":"repeat","href":"/core-concepts/workflows"},{"title":"Search","icon":"magnifying-glass","href":"/core-concepts/search"},{"title":"Portals","icon":"door-open","href":"/core-concepts/portals"},{"title":"Views","icon":"layer-group","href":"/core-concepts/views"}]},{"group":"Profile \u0026 Settings","pages":[{"title":"User Onboarding \u0026 Invitations","icon":"user-plus","href":"/profile-settings/user-onboarding"},{"title":"Profile Management","icon":"user","href":"/profile-settings/profile-management"},{"title":"Integrations \u0026 Connectors","icon":"plug-circle-plus","href":"/profile-settings/integrations"},{"title":"Email Digest","icon":"envelope","href":"/profile-settings/email-digest"}]},{"group":"Chat","pages":[{"title":"Basics \u0026 Navigation","icon":"map","href":"/chat/basics-navigation"},{"title":"Running Analyses","icon":"chart-mixed","href":"/chat/running-analyses"},{"title":"Analysis Notebooks","icon":"laptop-code","href":"/chat/analysis-notebooks"},{"title":"Share Chat Conversations","icon":"share-nodes","href":"/chat/share-conversations"},{"title":"Rooms","icon":"users","href":"/chat/rooms"},{"title":"Inbox","icon":"inbox","href":"/chat/inbox"},{"title":"File Uploads","icon":"file-upload","href":"/chat/file-uploads"},{"title":"Memory","icon":"brain","href":"/chat/memory"},{"title":"Observatory Cards","icon":"comment-dots","href":"/chat/observatory-cards"},{"title":"Best Practices","icon":"lightbulb","href":"/chat/best-practices"},{"title":"Templates","icon":"bookmark","href":"/chat/templates"}]},{"group":"Metrics","pages":[{"title":"Metrics","icon":"arrow-trend-up","href":"/metrics/overview"},{"title":"Managing Metrics","icon":"sliders","href":"/metrics/manage"},{"title":"Metrics Catalog","icon":"gauge","href":"/metrics/catalog"}]},{"group":"Dashboards","pages":[{"title":"Dashboards","icon":"table-columns","href":"/dashboards/overview"},{"title":"Filter and Explore","icon":"filter","href":"/dashboards/explore"},{"title":"Investigate","icon":"magnifying-glass-chart","href":"/dashboards/investigate"},{"title":"Edit a Dashboard","icon":"pen-to-square","href":"/dashboards/edit"},{"title":"Slice Cards","icon":"wave-square","href":"/dashboards/slice-cards"},{"title":"Publish and Share","icon":"share-nodes","href":"/dashboards/publish"}]},{"group":"Workflows","pages":[{"title":"Create a Workflow","icon":"plus","href":"/workflows/create"},{"title":"Outputs and Delivery","icon":"paper-plane","href":"/workflows/outputs"},{"title":"Manage Workflows","icon":"sliders","href":"/workflows/manage"},{"title":"Advanced Workflows","icon":"code-branch","href":"/workflows/advanced"},{"title":"Workflow Best Practices","icon":"lightbulb","href":"/workflows/best-practices"}]},{"group":"Context","pages":[{"title":"Context Pages","icon":"book","href":"/knowledge-base/overview"},{"title":"Creating \u0026 Managing Pages","icon":"square-plus","href":"/knowledge-base/creating-pages"},{"title":"External Wiki Integrations","icon":"puzzle-piece","href":"/knowledge-base/wiki-integrations"},{"title":"Best Practices","icon":"list-check","href":"/knowledge-base/best-practices"},{"title":"Metrics Catalog","icon":"signs-post","href":"/knowledge-base/metrics-catalog"}]},{"group":"Configuration","pages":[{"title":"Global Configuration","icon":"gear","href":"/configuration/global-configuration"},{"title":"Company Information","description":"Company context Orion applies to every project","icon":"building","href":"/configuration/company-information"},{"title":"User Management","icon":"users","href":"/configuration/user-management"},{"title":"Groups","description":"Model teams and departments as shared-access units","icon":"user-group","href":"/configuration/groups"},{"title":"Sudo","icon":"user-secret","href":"/configuration/sudo"},{"title":"SSO","icon":"key","href":"/configuration/sso"},{"title":"MCP Connectors","icon":"plug-circle-bolt","href":"/configuration/mcp-connectors"}]},{"group":"Version Control","pages":[{"title":"History and Review","icon":"clock-rotate-left","href":"/version-control/history-and-review"},{"title":"Sync Your Workspace to GitHub","sidebarTitle":"Sync to Git","tag":"Beta","icon":"github","href":"/version-control/sync-to-git"},{"title":"Export Orion Snapshots to Git","sidebarTitle":"Git snapshots","tag":"Beta","icon":"code-merge","href":"/version-control/git-snapshots"},{"title":"Export a Project","icon":"file-export","href":"/version-control/export"},{"title":"Import a Project","icon":"file-import","href":"/version-control/import"}]},{"group":"MCP Server","pages":[{"title":"MCP Server","icon":"server","href":"/mcp/overview"},{"title":"Setup","icon":"wrench","href":"/mcp/setup"},{"title":"Gemini Enterprise","icon":"google","href":"/mcp/gemini-enterprise"},{"title":"Tools Reference","icon":"screwdriver-wrench","href":"/mcp/tools"},{"title":"Troubleshooting","icon":"bug","href":"/mcp/troubleshooting"}]}]}]},"basePath":"","title":"User Management - Orion Public Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js"]}