> For the complete documentation index, see [llms.txt](https://docs.docbits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.docbits.com/administration-and-setup/settings/global-settings/groups-users-and-permissions/sub-organizations/how-to-create-a-sub-organization.md).

# How to create a Sub-Organization

## Create a new sub-organization

<div data-full-width="false"><figure><img src="https://578966019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2n2w4uDCJvv7CJ5zrdk%2Fuploads%2Fgit-blob-3fae4d0f0ad0bfe5567a20906333272497d41c21%2Fsub_organizations.png?alt=media" alt="Sub-Organizations List Overview"><figcaption></figcaption></figure></div>

Click on the `+ NEW` button

<figure><img src="https://578966019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2n2w4uDCJvv7CJ5zrdk%2Fuploads%2Fgit-blob-d8adfdd675df45ccf2ddf5656ad2307fb336657a%2Fsub_organization_new_button.png?alt=media" alt="Sub-Organization New Button" width="97"><figcaption></figcaption></figure>

The following menu will be displayed:

<figure><img src="https://578966019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2n2w4uDCJvv7CJ5zrdk%2Fuploads%2Fgit-blob-5d86dd5d97fc23f5a019bb5276ca4a3252f5e4e7%2Fs150-edit_user_in_sub_organization.png?alt=media" alt="English dialog for creating a sub-organization."><figcaption><p>English dialog for creating a sub-organization.</p></figcaption></figure>

Enter the details of the sub-organization you want to create, the name and description, then click on the `SAVE` button. You should then find your newly created sub-organization at the bottom of the list of existing sub-organizations.

## Editing sub organizations

<figure><img src="https://578966019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2n2w4uDCJvv7CJ5zrdk%2Fuploads%2Fgit-blob-2d3ea21ca9cd65d386dee3042214bfeec1f4b136%2Fedit_sub_organization_icon.png?alt=media" alt="Edit Sub-Organization Icon" width="161"><figcaption></figcaption></figure>

**Manage Users:**

<figure><img src="https://578966019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2n2w4uDCJvv7CJ5zrdk%2Fuploads%2Fgit-blob-9083e9295c86da65da2226308177e9b2aa91f003%2Fmanage_users_in_sub_organization.png?alt=media" alt="Manage Users in Sub-Organization" width="375"><figcaption></figcaption></figure>

* **Adding Users:** Administrators can create new user accounts and assign them to the appropriate sub-organization.
* **Assigning Roles and Permissions:** Administrators can set the roles and permissions for users within a suborganization. This typically involves assigning access rights to specific documents, folders or functions in the document management system.
* **Manage profile details:** Administrators can edit profile details of users within the sub-organization, such as: B. Contact information or department affiliation. This allows for updated and accurate management of user data.

<figure><img src="https://578966019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2n2w4uDCJvv7CJ5zrdk%2Fuploads%2Fgit-blob-91601abf12a9576335cfd0727284c320b3d4523f%2Fadd_user_to_sub_organization_modal.png?alt=media" alt="Add User to Sub-Organization Modal" width="375"><figcaption></figcaption></figure>

You can add a new user to the organization and have the option of whether to remove the user from other groups.

**Edit User:**

* **Editing suborganization settings:** Administrators can edit the settings and properties of a suborganization, including its name, description, or hierarchy level within the system.
* **Edit user details:** Administrators can edit the details of individual users within a sub-organization, for example to adjust their access rights or update their contact information.

**Delete User:**

* **Deleting sub-organizations:** Administrators may also have the ability to delete sub-organizations if they are no longer needed or if a restructuring of the organizational structure is required. When deleting a suborganization, administrators must ensure that all users and data associated with it are handled properly.

These management features enable administrators to effectively manage and adapt the user accounts and organizational structures within a document management system to meet the company's changing needs and processes.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.docbits.com/administration-and-setup/settings/global-settings/groups-users-and-permissions/sub-organizations/how-to-create-a-sub-organization.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
