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

# Organization

> Manage your organization hierarchy, layers, and access controls.

> [!NOTE]
>
> The Organization page becomes available after Cedar sets up your initial organization structure. Once enabled, you can manage your own organization hierarchy, including creating layers and assigning access.

Once your organization is set up, the **Organization** menu item appears in the sidebar, allowing you to manage your organization's structure.

![Organization page showing hierarchy tree and role bindings](https://mintcdn.com/cedaraiinc/3XL8_nY45kQdoBAs/images/admin/organization-page.png?fit=max\&auto=format\&n=3XL8_nY45kQdoBAs\&q=85\&s=c3c20d70f2718575cc0f8178b2219148)

Organization management page with hierarchy and bindings

## What you can do

> [card] View hierarchy
>
> See your organization's structure as a visual tree

> [card] Create layers
>
> Add new organizational layers (divisions, regions, etc.)

> [card] Reparent items
>
> Drag and drop to reorganize the hierarchy

> [card] Manage bindings
>
> Assign roles and access at each level

## Understanding the hierarchy

The organization hierarchy is a tree structure that represents how your business is organized.⁠‌‌​​​‌​‌‌​​​​​‌​​‌​‌​​‌‌⁠ Each level in the hierarchy can have:

* **Name** — A descriptive label for the layer
* **Child layers** — Sub-divisions nested underneath
* **Bindings** — Role assignments that grant access at this level

> [!TIP]
>
> Access is inherited down the hierarchy. Users with access to a parent layer automatically have access to all child layers beneath it.

## Create a new layer

Layers allow you to structure your organization into logical divisions (e.g., regions, departments, business units).

**1. Click New Layer**

From the Organization page, click the **New layer** button in the Hierarchy section.

**2. Enter layer name**

Give the layer a descriptive name that reflects its purpose in your organization.

**3. Select parent**

Choose the parent layer in the hierarchy. Select "No Parent" for a top-level layer, or choose an existing layer to nest underneath.

**4. Create and configure**

Click **Create Layer**, then configure bindings to grant access at this layer level.

![Create Layer dialog with name and parent selection](https://mintcdn.com/cedaraiinc/3XL8_nY45kQdoBAs/images/admin/create-layer-dialog.png?fit=max\&auto=format\&n=3XL8_nY45kQdoBAs\&q=85\&s=92af1e9b5271186ac263b765ef003445)

Create Layer dialog

### Dialog fields explained

| Field | Description |
| - | - |
| **Name** | A descriptive name for the layer (e.g., "West Region", "Operations Division") |
| **Parent** | The parent layer in the hierarchy, or "No Parent" for top-level layers |

## Reorganize with drag and drop

You can rearrange the hierarchy by dragging layers to new positions:

1. Click and hold on a layer in the tree
2. Drag it to its new parent
3. Release to reparent the layer

> [!WARNING]
>
> Reparenting a layer moves all its children and affects access inheritance. Users who had access through the old parent may lose access after the move.

## Manage bindings at each level

Each layer in the hierarchy can have its own bindings.⁠‌‌​​​‌​‌‌​​​​​‌​​‌​‌​​‌‌⁠ Click on a layer to see and manage its bindings in the right panel.

| Column | Description |
| - | - |
| **Group** | The user group that has access |
| **Role** | The permissions granted |
| **Resource** | The scope of access (Organization, Carrier, etc.) |

> [!NOTE]
>
> Bindings at a higher level in the hierarchy cascade down to all child layers. You don't need to recreate bindings at every level.

## Best practices

> [accordion] Mirror your business structure
>
> Design your hierarchy to match how your organization actually operates. This makes it intuitive for users to understand access levels.

> [accordion] Keep it simple
>
> Avoid creating too many layers. A deep hierarchy can be confusing and harder to manage. Most organizations work well with 2-4 levels.

> [accordion] Use descriptive names
>
> Layer names should be immediately understandable. Avoid abbreviations or codes that require explanation.

> [accordion] Plan before you build
>
> Sketch out your hierarchy before creating it. Reorganizing later is possible but affects access inheritance.

## Getting started with organizations

> [!NOTE]
>
> Organizations are set up by Cedar as part of the initial configuration.⁠‌‌​​​‌​‌‌​​​​​‌​​‌​‌​​‌‌⁠ Contact your account representative to enable organization management for your account.

To request organization setup:

1. Contact Cedar support or your account representative
2. Describe your organizational structure needs
3. Cedar will configure the initial structure in the [Tools](https://docs.cedarai.com/user-docs/admin/tools-api-keys.md) page
4. Once set up, the Organization menu item appears and you can manage it yourself

## Related pages

> [card] [Tools & Advanced Settings](https://docs.cedarai.com/user-docs/admin/tools-api-keys.md)
>
> Initial organization setup and advanced options

> [card] [Bindings](https://docs.cedarai.com/user-docs/admin/bindings.md)
>
> Learn more about role bindings

> [card] [User Groups](https://docs.cedarai.com/user-docs/admin/user-groups.md)
>
> Manage the groups that get access

> [card] [IAM Concepts](https://docs.cedarai.com/user-docs/iam/concepts.md)
>
> Deep dive into access control


## Related topics

- [Tools & API Keys](https://docs.cedarai.com/user-docs/admin/tools-api-keys.md)
- [Overview](https://docs.cedarai.com/user-docs/admin/overview.md)
- [Glossary](https://docs.cedarai.com/user-docs/admin/glossary.md)
- [Dashboard](https://docs.cedarai.com/user-docs/admin/dashboard.md)
- [Customer Users](https://docs.cedarai.com/user-docs/iam/customer-users.md)
