# Entity Management

All projects are attached to an [Entity](/resources/dictionary.md#entity). Small organizations may create only a single entity under which all projects exist. Within large organizations, the number of projects under a single entity tends to become unwieldy.

To resolve this issue, we allow organizations to create entities that reflect the hierarchical structure of their teams. When you log in, you are automatically dropped into your default business unit entity. From here, you can access all of the projects you are authorized to view, as shown below. 

### Adding an Entity

Adding a new Entity to your entity tree can be accomplished using the Entity Manager. The Entity Manager can be found under the Admin link on the top menu bar. 

![](/files/-Misls9nCvBCz0F1mDiI)

By default, only the root Entities are displayed, which are those directly attached to the organization. However, you may open each to display the entire Entity tree.

![](/files/-MismJAkRgKK-60m24KH)

Selecting an Entity from the Entity Tree provides you with the ability to add a child Entity. Click "Add Entity" and, from the provided dialogue, enter the child Entity name and type and click "Save."

![](/files/-Misn78qI2caIEjr4MMQ)

The new Child entity will appear in the Entity tree.

### Renaming an Entity

Select the Entity you wish to rename from the Entity tree on the left. The Entity information will appear on the right and be edited accordingly. Renaming your Entity will not change the EntityID.

![](/files/-MisnsMdPBtE1IuLDWjT)

### Removing an Entity

You may remove an Entity if it meets the following criteria:

1. The Entity has no child Entities
2. The Entity has no projects


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.threatrix.io/administration/entity-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.