# Structure Your Organization

The Organizations section allows you to create and manage hierarchical organizational structures within Atra RMS. This enables logical separation of devices, vpn tunnels, users, and roles.

**Structure:**

Level 1: Parent Organization  
<span> ├── Level 2: Child Organization A</span>

<span> │ ├── Level 3: Child Organization A1</span>

<span> │ └── Level 3: Child Organization A2</span>

<span> └── Level 2: Child Organization B</span>

<span> └── Level 3: Child Organization B1</span>

**Key Principles:**

- The Atra-RMS uses a strict 3-level hierarchy for management
- Organizations form parent-child relationships
- Parent can view child org resources
- Child cannot view parent org resources
- A Level 3 organization cannot create any child organizations

# View and Manage Child-Organizations

The main Organizations interface displays all child organizations under your management.

[![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/4PXimage.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/4PXimage.png)

#### Interface Actions

[![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/xhSimage.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/xhSimage.png)

<div align="left" dir="ltr" id="bkmrk-action-location-purp"><table border="1" style="border-collapse: collapse; border-style: solid;"><colgroup><col width="141"></col><col width="128"></col><col width="258"></col></colgroup><thead><tr><td>Action

</td><td>Location

</td><td>Purpose

</td></tr></thead><tbody><tr><td>+CREATE Button

</td><td>Top-left (Teal)

</td><td>Add new child organization

</td></tr><tr><td>Refresh Button

</td><td>Top-right

</td><td>Manually update organization list

</td></tr><tr><td>Search Bar

</td><td>Center

</td><td>Filter by organization name or creator

</td></tr><tr><td>Filter

</td><td>Top-right

</td><td>Currently not available

</td></tr></tbody></table>

</div>---

#### Table Columns

<div align="left" dir="ltr" id="bkmrk-column-description-e"><table border="1" style="border-collapse: collapse; border-style: solid;"><colgroup><col width="104"></col><col width="283"></col><col width="236"></col></colgroup><thead><tr><td>Column

</td><td>Description

</td><td>Example

</td></tr></thead><tbody><tr><td>Name

</td><td>Child organization identifier

</td><td>AMC, MMC, etc.

</td></tr><tr><td>Device Count

</td><td>Total devices registered to that organization

</td><td>25

</td></tr><tr><td>Created By

</td><td>Username who created the organization

</td><td>Demo User

</td></tr><tr><td>Created At

</td><td>Date and time of creation

</td><td>Dec 15, 2025, 10:30 AM

</td></tr></tbody></table>

</div>[![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/V9gimage.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/V9gimage.png)

---

#### Table Navigation

[![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/pNBimage.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/pNBimage.png)

<div align="left" dir="ltr" id="bkmrk-control-purpose-opti"><table border="1" style="border-collapse: collapse; border-style: solid;"><colgroup><col width="127"></col><col width="223"></col><col width="208"></col></colgroup><thead><tr><td>Control

</td><td>Purpose

</td><td>Options

</td></tr></thead><tbody><tr><td>Rows per page

</td><td>Adjust visible organizations

</td><td>5, 10, 15, 20,25

</td></tr><tr><td>Total Count

</td><td>Display total child organizations

</td><td>"Showing 1-5 of 25"

</td></tr><tr><td>Page Navigation

</td><td>Move between pages

</td><td>Previous, Next, Last, First

</td></tr></tbody></table>

</div>---

[![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/PV8image.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/PV8image.png)

# Child Organization Creation Guide

Follow these steps to create a new child organization under your current organization.

#### Step 1: Navigate to Creation Form

1. Click "Organizations" in left sidebar menu
2. Click "+CREATE" button (Teal, top-left corner)
3. "Create New Organization" page loads

---

#### Step 2: Complete Organization Form

[![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/8Z8image.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/8Z8image.png)

##### Organization Name (Required)

Input Rules:

- Length: 3-40 characters
- Allowed: Letters, numbers, spaces, periods (.), underscores (\_), hyphens (-)
- Not allowed at start/end: Period (.), underscore (\_), hyphen (-)
- No consecutive special characters: Avoid org..name or org--name

Examples:

- ✅ Atreyo Research and Development LLP
- ✅ Reliance Industries
- ✅ Google Cloud Platform
- ✅ Mumbai\_Branch\_Office
- ❌ \_Organization (starts with underscore)
- ❌ Org..Name (consecutive periods)
- ❌ Department- (ends with hyphen)

💡 Naming Best Practices:

- Use clear, descriptive names reflecting business structure
- Consider geographic location: "Mumbai\_Office", "Delhi\_Warehouse"
- Consider function: "R&amp;D\_Lab", "Production\_Floor\_A", "Sales\_Team\_North"
- Maintain consistent naming convention across all organizations

---

#### Step 3: Submit Form

<div align="left" dir="ltr" id="bkmrk-button-color-action-"><table border="1" style="border-collapse: collapse; border-style: solid;"><colgroup><col width="81"></col><col width="95"></col><col width="245"></col></colgroup><thead><tr><td>Button

</td><td>Color

</td><td>Action

</td></tr></thead><tbody><tr><td>CREATE

</td><td>Teal

</td><td>Submit and create new organization

</td></tr><tr><td>RESET

</td><td>Teal outline

</td><td>Clear form fields

</td></tr><tr><td>CLOSE

</td><td>Red outline

</td><td>Cancel and return to list

</td></tr></tbody></table>

</div>---

#### Important Notes

Automatic Parent Assignment:

⚠️ The new organization you create will automatically become a child of your current organization (the one the logged-in user belongs to).

Example:

- You belong to: "ATREYO" (Level 1)
- You create: "AMC"
- Result: "AMC" becomes Level 2 child under "ATREYO"

Cannot Choose Parent:

- You cannot select a different parent organization
- New organization always created under your current organization
- To create under different parent, switch to that organization first

---

#### After Creation

Immediate Effects:

1. New organization appears in Child Organizations list
2. Organization is assigned Level = (Your Level + 1)
3. You can now:

- Register devices to this organization
- Create roles specific to this organization
- Invite users to this organization
- Create further child organizations under it (Level 3)

Next Steps:

- Create Roles: Define permissions specific to this organization
- Invite Users: Add team members to the new organization
- Register Devices: Assign devices to the organization

---