> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mantrixflow.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 MantrixFlow. 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/devnooks/Hugd7ROTeIjoDzBI/images/user-guide/ug-organization-create-form.png?fit=max&auto=format&n=Hugd7ROTeIjoDzBI&q=85&s=e36c843f29b9d8c850b827ea975994d7" 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/devnooks/Hugd7ROTeIjoDzBI/images/user-guide/ug-organization-switcher.png?fit=max&auto=format&n=Hugd7ROTeIjoDzBI&q=85&s=8bf268b743b4ec70d6731b80eefa834e" 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/devnooks/Hugd7ROTeIjoDzBI/images/user-guide/ug-settings-organization.png?fit=max&auto=format&n=Hugd7ROTeIjoDzBI&q=85&s=adb35d0e7a70856c06b7c9d845ee3ac8" 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.
