Repository Public
1<!-- source: https://docs.x.ai/grok/organization (from https://docs.x.ai/llms-full.txt, retrieved 2026-09-19T05:28:55Z) -->2#### Grok Business / Enterprise34# Organization Management56**Organizations provide a higher-level governance structure for enterprise customers, encompassing multiple console teams under unified IT controls.** Available only to Enterprise tier subscribers, organizations enable centralized management of users, teams, and security features like SSO.78Access the organization dashboard by visiting [console.x.ai/organization](https://console.x.ai/organization?utm_source=docs\&utm_medium=referral\&utm_campaign=grok-organization\&utm_content=organization). This page is restricted to organization admins.910> [!NOTE]11>12>  Organizations are exclusive to the Enterprise tier. Contact xAI13> sales to upgrade if needed.1415## Understanding Organizations1617An organization acts as an overarching entity that groups related console teams, ideal for large enterprises with multiple business units or departments.1819Key features:2021* **Domain Association:** Link your organization to a specific email domain (e.g., @yourcompany.com). Any user signing up or logging in with an email from this domain is automatically associated with the organization.22* **User Visibility:** Organization admins can view a comprehensive list of all associated users across teams on the `/organization` page.23* **Team Association:** Teams created by organization members are automatically linked to the organization and displayed in the dashboard for oversight.2425This structure supports a multi-team architecture, allowing independent Grok Business or API teams while maintaining centralized governance, such as uniform access controls and auditing.2627## Viewing Users and Teams2829To view users:30311. Navigate to [console.x.ai/organization](https://console.x.ai/organization?utm_source=docs\&utm_medium=referral\&utm_campaign=grok-organization\&utm_content=organization).322. Scroll to the "Users" section for a list of all domain-associated users, including their team affiliations and access status.3334To view teams:35361. In the same dashboard, access the "Teams" section.372. Review associated console teams, their members, and high-level usage metrics.3839Use these views to ensure compliance, spot inactive accounts, or identify growth needs.4041## Setting Up SSO4243Secure and streamline logins by integrating Single Sign-On (SSO) with your preferred Identity Provider (IdP).4445To configure SSO:46471. On the `/organization` page, click "Configure SSO".482. Choose your IdP from the supported list (e.g., Okta, Azure AD, Google Workspace).493. Follow the self-guided, IdP-specific instructions provided—each includes step-by-step setup, metadata exchange, and attribute mapping details.504. Save your configuration and test SSO to confirm the functionality.5152SSO setup is straightforward and tailored to common providers, ensuring quick deployment.5354## Activating SSO and User Impact5556Once configured, SSO will be activated and enforced organization-wide.5758Post-activation:5960* Users must log in via SSO on their next access.61* If a user selects "Log in with email" and enters a domain-associated address, (e.g., @yourcompany.com) the system automatically detects it and redirects to your IdP for authentication.62* Non-domain emails (e.g., @differentcompany.com) fall back to standard login methods.6364This ensures seamless, secure access without disrupting workflows.6566> [!NOTE]67>68>  Notify your users in advance about the SSO rollout to minimize69> support queries.7071## Setting up SCIM7273Automate user provisioning and deprovisioning by integrating System for Cross-domain Identity Management (SCIM) with your Identity Provider (IdP). Follow these steps to set up SCIM effectively.7475### Step 1: Configure directory sync in your IdP76771. On the `/organization` page, click "Setup SCIM".782. Follow the IdP-specific steps provided to connect your directory.793. Create groups in your IdP that correspond to how you want to organize access in xAI—for example, `xai-engineering`, `xai-data-science`, or whatever fits your organizational structure.8081This step ensures your directory is synced and your groups are ready for mapping.8283### Step 2: Create roles8485Define the roles your organization needs directly in the xAI console.8687* Click **"Create Role"** to add a new role. Each role gets a name, a slug (used as a unique identifier), and an optional description.88* Create as many roles as you need to match your organizational structure—there is no limit.89* **Drag to reorder** roles by priority. Higher-priority roles take precedence when a user belongs to multiple groups.90* The **Member** role is always present at the bottom of the list as the default role assigned to users without any specified group.9192You can also create and reorder roles later from the Provisioning tab on the organization page.9394### Step 3: Map groups to roles9596Map your IdP groups to the roles you created in the previous step.97981. On this step, click **"Assign Groups"** to open the management portal at **sso.x.ai**.992. Click **"Configure role assignment"** to set up group-to-role mappings.1003. For each IdP group, select the corresponding xAI role.101102This mapping aligns your IdP groups with xAI's role-based access controls so that users are automatically assigned the correct role when provisioned.103104### Step 4: Configure roles with teams, permissions, and licenses105106Assign your roles to the appropriate resources.107108* **Teams:** Map each role to one or more console teams.109* **Permissions:** Assign the access control lists (ACLs) each role should have.110* **Licenses:** Associate the appropriate product license (e.g., Grok Business) with the role.111112This step customizes access and entitlements based on your organizational needs.113114### Step 5: Preview and activate SCIM115116Before finalizing, review the changes.117118* We provide a preview of what your organization will look like after activation.119* Confirm that members are assigned to the correct roles, those roles have the appropriate level of authorization, and the right licenses are applied.120* Once you feel confident everything is correct, click **"Activate"** to make SCIM your default provisioning system.121122This verification ensures a smooth transition.123124> [!WARNING]125>126>  SCIM is very disruptive. Users might lose or gain access to resources127> they did not have before. Notify your organization that you are undergoing this transition and128> **verify everything is correct during the preview stage before proceeding.**129130### Managing roles after activation131132After SCIM is activated, you can continue to manage roles from the **Provisioning** tab on the organization page:133134* **Create new roles** using the "Create Role" button in the SCIM Roles section header.135* **Reorder role priority** using the "Reorder Priority" button.136* **Configure roles** by clicking the overflow menu on any role to update its teams, permissions, and licenses.137138## Need Help?139140For assistance with organization setup, SSO troubleshooting, or Enterprise features, contact xAI sales at [x.ai/grok/business/enquire](https://x.ai/grok/business/enquire).141