> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravenna.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Organizations

> Organizations are the top-level container in Ravenna that hold workspaces, members, integrations, billing, and shared settings for your company.

An organization represents your company in Ravenna. It is the top-level container that holds all of your <Tooltip headline="Workspaces" tip="Dedicated spaces for each team or department to manage support requests." cta="Learn about workspaces" href="/documentation/platform/workspaces/overview">workspaces</Tooltip>, members, <Tooltip headline="Integrations" tip="Third-party tools connected to your organization." cta="View integrations" href="/integrations/overview">integrations</Tooltip>, and settings.

Every Ravenna user belongs to at least one organization.

## How organizations and workspaces relate

Your organization contains one or more workspaces. Each workspace is a separate space for a team or department to manage their own support requests, with independent channels, tickets, forms, and settings.

Settings are split between the two levels:

* **Organization settings** apply across your entire account, including branding, <Tooltip headline="SSO" tip="Single Sign-On allows your team to authenticate through your corporate identity provider." cta="Learn about SSO" href="/integrations/sso/overview">SSO</Tooltip>, notification policy defaults, and member management.
* **Workspace settings** are scoped to individual teams, including <Tooltip headline="Channels" tip="Channels connect Slack to your workspace for ticket routing." cta="Learn about channels" href="/documentation/tickets/channels">channels</Tooltip>, ticket statuses, <Tooltip headline="SLAs" tip="Service level agreements define response and resolution time targets." cta="Learn about SLAs" href="/documentation/automate/slas">SLAs</Tooltip>, <Tooltip headline="Workflows" tip="Automate ticket routing, tagging, and actions." cta="Learn about workflows" href="/documentation/automate/workflows/overview">workflows</Tooltip>, and API keys.

<Callout icon="link" color="#6B7280">
  Learn more about [organization settings](/documentation/platform/organizations/settings) and [workspace settings](/documentation/platform/workspaces/settings).
</Callout>

## Organization roles

An organization role is a person's baseline across the entire account. Everyone has exactly one:

* **Admins** have full control over organization settings, integrations, and member management.
* **Members** reach public workspaces automatically with requester access, which lets them file and track their own tickets. They cannot manage organization-level settings. To work a workspace's queue, a member must be added to that workspace.
* **Guests** have no automatic workspace access, even to public workspaces. They reach a workspace only when explicitly added. By default, guests cannot see your organization in their workspace switcher. Admins can enable guest visibility in **Organization Settings > General**, which also lets guests use the <Tooltip headline="Portal" tip="Self-service home where end users submit and track requests" cta="Learn about the Portal" href="/documentation/platform/portal">Portal</Tooltip>.

The organization role is only the baseline. What someone can do inside a specific team is decided by their workspace access on top of it.

<Callout icon="link" color="#6B7280">
  For how organization roles combine with workspace access, and the full capability matrix, see [Roles and access](/documentation/platform/roles-access).
</Callout>

## How people join your organization

People are added to your organization automatically. There is no manual "invite to organization" step. Someone becomes an organization member in one of these ways:

* **Single sign-on**: the first time a person signs in through your <Tooltip headline="SSO" tip="Single Sign-On through your corporate identity provider." cta="Learn about SSO" href="/integrations/sso/overview">SSO</Tooltip> connection, Ravenna creates their organization membership.
* **Identity provider or HRIS sync**: people synced from an <Tooltip headline="Integration" tip="A connected identity provider or HRIS such as Okta, Google Workspace, or HiBob." cta="View integrations" href="/integrations/overview">integration</Tooltip> are added automatically.
* **Added to a workspace**: when a workspace admin adds someone by email who is not yet in the organization, their organization membership is created at the same time (see [Add someone to a workspace](/documentation/platform/workspaces/overview#add-someone-to-a-workspace)).
* **Submitting a request**: when someone new sends a request by email, Slack, or Teams, Ravenna creates them as a guest so the request can be tracked.

<Info>
  People whose email matches your company domain join as **Members**. People synced from an integration on a different email domain join as **Guests**. Enable **Guest visibility** in organization settings before guests can sign in.
</Info>

## Managing organization members

<Steps>
  <Step title="Open organization members">
    Go to <Tooltip headline="Organization settings" tip="Organization-wide policies, integrations, and members." cta="View organization settings" href="/documentation/platform/organizations/settings">organization settings</Tooltip> and click the **Members** tab.
  </Step>

  <Step title="Edit a member">
    Click the menu on a member's row and select **Edit** to change their organization role or set a delegate. See [organization roles](/documentation/platform/roles-access#organization-roles) for what each role can do.
  </Step>

  <Step title="Remove a member">
    Select members and use the bulk action bar to remove them from the organization.
  </Step>
</Steps>

Changing someone's organization role changes their baseline everywhere: promoting a member to admin grants organization-wide control, and downgrading an admin to guest removes their automatic access to public workspaces. It does not change any explicit workspace memberships they already hold. Removing someone from the organization also removes them from every workspace, because [organization membership is required before workspace membership](/documentation/platform/roles-access).

<Warning>Ravenna prevents removing the last organization admin so administrative access is never lost.</Warning>

### Set member delegates

Assign a delegate to receive a member's ticket assignments and approvals while they are unavailable.

* **Manager**: uses the member's direct manager (requires the <Tooltip headline="Okta integration" tip="Identity provider integration for user and manager data." cta="Learn about Okta setup" href="/integrations/okta/overview">Okta integration</Tooltip> for manager data)
* **Specific user**: any organization member
* **No delegate**: removes delegation

<Info>
  Members can set their own delegates in [user settings](/documentation/platform/my-settings). Admin changes override a member's own setting.
</Info>

## Access controls

Organization admins can configure access in **Organization Settings > General**:

* **Workspace creation**: Restrict who can create new workspaces (admins only or all members).
* **Guest visibility**: Let organization guests see and sign in to your organization and use the Portal. Off by default.

<Callout icon="link" color="#6B7280">
  Learn more about [organization settings](/documentation/platform/organizations/settings) and adding people to a team in [Workspaces](/documentation/platform/workspaces/overview#add-someone-to-a-workspace).
</Callout>
