# Setting up Department

### Creating a Department

Step 1: Navigate From the left sidebar, select Organization.

Step 2: Select the organization intended for the new department.

Step 3: You will land on the *Members* tab. Switch to the Departments tab. *(Note: If this is your first time, the list will say "No Departments found".)*

Step 4: Initiate Setup Click the Add Department button to launch the configuration modal.

Step 5: Configuration Settings

* Department Name: Enter a unique title (e.g., "Marketing", "legal"). *(Required)*
* Department Manager: You may immediately assign a Team or Member to manage this unit, or leave it blank to assign later. *(Optional)*

Step 6: Finalize Click Confirm to save the new entry.

<figure><img src="https://437457296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MN4F4-qybg8XDATvios%2Fuploads%2Ft1qG24xriDTCQOGN9pGh%2Fchrome_pkEewY61Ws.png?alt=media&#x26;token=0803362b-f142-4e24-b6d8-90d409bfac7d" alt=""><figcaption></figcaption></figure>

Once created, click the department name (or the ... menu) to enter the Department view. This view mirrors the global layout but is strictly scoped to this specific department.

<figure><img src="https://437457296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MN4F4-qybg8XDATvios%2Fuploads%2FHgPof6q53mdY4J9Vs2Wm%2Fchrome_Zjmo8qSxLF.png?alt=media&#x26;token=cfdcb6bb-6019-4ce6-9a04-41fa5f061a53" alt=""><figcaption></figcaption></figure>

### Department Detail

The Department view mirrors the organization-level layout, featuring a specific Department Access tab.

* Navigation: Toggle between familiar tabs (Members, Teams, etc.) to manage department-specific data.
* Department Access: This tab is dedicated to Governance. Its only role is to view current managers or assign new ones.

{% hint style="success" icon="shield-quartered" %}

#### **Key Concept: Scope & Isolation**&#x20;

Everything created inside this view stays inside.

* Teams created here belong *only* to this Department.
* Members added here are associated *only* with this branch.
* This ensures that your "Engineering" teams do not clutter the "Sales" views.
  {% endhint %}

### Moving Org. Resources to Department

Now that your Department is created, it is currently an empty container. If you have been using the platform for a while, your Global Organization is likely already filled with active Teams, Spaces, and Space Roles.

Instead of creating everything from scratch, Global Admins can easily migrate existing global resources directly into a new Department. This is the crucial step to transition your workspace from a cluttered "Flat Organization" into a clean, scalable structure.

#### The Benefit of Migrating Resources:

Moving items into a Department is the key to delegating your workload. When you transfer a global Team, Space, or Space Role into a Department, you grant the assigned Department Manager the authority to handle its day-to-day operations.

{% hint style="info" %}

#### Note on Admin Visibility:

Moving a resource does not hide it from you. Global Admins retain 100% visibility and ultimate control over everything inside every Department. You are simply sharing the management responsibilities.
{% endhint %}

#### How to Migrate a Resource:

To move an existing global resource into your new Department, follow these steps (It's same for every resource):

Step 1: Navigate to Organization Resources. Go to your main Organization view and open the tab of the resource you want to move (Teams, Spaces, or Space Roles).

Step 2: Select the item. Locate the specific Team, Space, or Role you wish to migrate and open its detail (*by clicking the item* or its `...`).

<figure><img src="https://437457296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MN4F4-qybg8XDATvios%2Fuploads%2F5lvSm5Bc1Hw5Yjk8sVV7%2Fchrome_ZbSwlvVFJI.png?alt=media&#x26;token=b48c40b3-1fa0-4781-be2c-a2a40c365f01" alt=""><figcaption></figcaption></figure>

Step 3: Click Update Space/Team/Roles.

Step 4: Assign the Department. Locate the Department field in the configuration modal.

Step 5: Save and Transfer. Select your newly created Department from the dropdown menu and click Update.

<figure><img src="https://437457296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MN4F4-qybg8XDATvios%2Fuploads%2FToeZa7B2v4CFxlTrekbh%2Fimage.png?alt=media&#x26;token=9f0a3253-b496-42b0-978b-2e4995825df6" alt=""><figcaption></figcaption></figure>

### Assigning Department Managers

To delegate authority, you must assign a Manager. You can do this from two locations:

{% hint style="info" %}

#### Role Restriction

Only Viewers can be assigned as Department Managers. Admins and Owners already have global access. To get better understanding of organizations members read [Organization Introduction](https://docs.decisionrules.io/doc/organization/organization-introduction).
{% endhint %}

#### Local Assignment (Department Scope)

1. Navigate inside the specific Department.
2. Open the Department Access tab.
   1. Click Add Department Access.
3. Select the user (Viewers only) or team to assign as Manager.

{% hint style="warning" %}

#### Team Access

Assigned teams only grant management access to members holding the Viewer role. Members within the team remain restricted.
{% endhint %}

<figure><img src="https://437457296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MN4F4-qybg8XDATvios%2Fuploads%2FS6OSwog2MbweWtB90N6c%2Fchrome_bhD8ld0wem.png?alt=media&#x26;token=c98ca3b1-e599-4d35-8378-fd1dcd2f992e" alt=""><figcaption></figcaption></figure>

#### (Global) Policies Tab

Go to the -> Policies menu and select the Department Policies tab to manage assignments across the entire organization. For more info visit documentation about [Policies](https://docs.decisionrules.io/doc/organization/policies).

### Summary of Delegation

By completing the steps above, you have successfully moved the workload from the Global Admin to the Department Manager.

The assigned Manager now has the authority to:

* Manage Locally: Create and govern Teams, Spaces, and Space Roles strictly within their assigned department.
* Pull from Global: Invite existing individual members from the wider organization into their specific department's Teams or Spaces.
* Grant Access (Local & Global): Define who sees what inside their department. To do this, Managers can use the Teams and Space Roles they created locally, or they can leverage existing Global Teams and Global Space Roles to grant access.

{% hint style="warning" %}

#### Utilizing Global Resources:&#x20;

If a Manager uses a Global Team or Global Space Role to grant access to a departmental space, any modifications made to those global items by an Admin (e.g., changing the permissions of a Global Role, or adding users to a Global Team) will automatically take effect within the department as well.
{% endhint %}

```mermaid
graph TD
    %% --- STYLING ---
    classDef admin fill:#263238,stroke:#000,stroke-width:2px,color:#fff;
    classDef manager fill:#fff,stroke:#000,stroke-width:1px,color:#000;
    classDef scope fill:#e3f2fd,stroke:#2196f3,stroke-width:2px,stroke-dasharray: 5 5;
    classDef safe fill:#fff,stroke:#4caf50,stroke-width:2px,color:#2e7d32;
    classDef note fill:#fff9c4,stroke:#fbc02d,stroke-width:2px,stroke-dasharray: 5 5,color:#f57f17;

    %% --- NODES ---
    GlobalAdmin["🏢 Global Admin"]:::admin

    subgraph DepartmentScope ["🟢 Department Scope"]
        direction TB
        
        DeptManager["🦸 Department Manager<br/>(Carl/John)"]:::manager

        %% The Outputs (All on the same level)
        Users(("👥 Org.<br/>Resources")):::safe
        Teams["🚀 Manage:<br/>Teams, Spaces<br/>and Create Policy"]:::safe
        Note["✅ <b>No Global Admin Rights Needed</b><br/>Manager has full power ONLY inside here."]:::note
        
        %% --- CONNECTIONS INSIDE ---
        %% 1. Manager -> Users
        DeptManager -->|2. Pulls Members, Teams, Space Roles| Users
        
        %% 2. Manager -> Teams
        DeptManager -->|3. Creates| Teams

        %% 3. Manager -> Note (Invisible link to place it side-by-side)
        DeptManager ~~~ Note
    end

    %% --- GLOBAL CONNECTION ---
    GlobalAdmin -->|1. Creates Dept &<br/>Delegates Authority| DeptManager

    %% --- STYLES ---
    %% Link 0: Manager -> Users (Orange)
    linkStyle 0 stroke:#f57f17,stroke-width:2px;
    
    %% Link 1: Manager -> Teams (Orange)
    linkStyle 1 stroke:#f57f17,stroke-width:2px;

    %% Link 3: Admin -> Manager (Black)
    %% Note: We skip Link 2 because ~~~ (invisible link) cannot be styled
    linkStyle 3 stroke:#000,stroke-width:3px;
```