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

# Organizations and workspace context

> Manage organizations in the live app so production, staging, teams, and audit history stay clearly separated.

Organizations are the top-level boundary in Arcyria. Every connection, pipeline, activity event, and team role is scoped to the active organization.

## Relevant routes

* Organizations list: `/organizations`
* Create organization: `/organizations/new`
* Edit organization: `/organizations/[id]/edit`
* Workspace settings: `/workspace/settings?tab=organization`

## Why organizations matter operationally

Use organizations to separate:

* production from staging
* internal data from client-facing workloads
* regulated datasets from general analytics work
* different business units with different operators

## Create a new organization

From the organizations list or sidebar switcher, create a new organization with a clear name, slug, and optional description. A good naming pattern is environment plus team, such as `Growth Production` or `Data Platform Staging`.

<img src="https://mintcdn.com/arcyria/E7JOPWjj_d9bTYoT/images/user-guide/ug-organization-create-form.png?fit=max&auto=format&n=E7JOPWjj_d9bTYoT&q=85&s=d3878a4396bb1294184775477032d6f6" alt="Create organization form" width="1572" height="976" data-path="images/user-guide/ug-organization-create-form.png" />

## Switch context before making changes

The organization switcher in the sidebar controls which connections and pipelines you are editing. Always confirm the active organization before rotating credentials or changing schedules.

<img src="https://mintcdn.com/arcyria/E7JOPWjj_d9bTYoT/images/user-guide/ug-organization-switcher.png?fit=max&auto=format&n=E7JOPWjj_d9bTYoT&q=85&s=6b803c28353d64ec666f3b4ad0bb62fb" alt="Organization switcher menu" width="1572" height="976" data-path="images/user-guide/ug-organization-switcher.png" />

## Update organization details

Owners can manage name, slug, and description from **Settings -> Organization**.

<img src="https://mintcdn.com/arcyria/E7JOPWjj_d9bTYoT/images/user-guide/ug-settings-organization.png?fit=max&auto=format&n=E7JOPWjj_d9bTYoT&q=85&s=f0f36b56b37dd2dde3e62b49b2153131" alt="Settings - Organization tab" width="1572" height="976" data-path="images/user-guide/ug-settings-organization.png" />

## A practical operating pattern

Many teams keep:

* one production organization with live credentials and schedules
* one staging organization with test data and manual-only runs
* identical connection names across both, prefixed by environment

That makes promotion and troubleshooting much safer.
