> For the complete documentation index, see [llms.txt](https://docs.bfore.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bfore.ai/docs/console/introduction/multi-tenant-organizations.md).

# Multi-tenant organizations

Organizations with multiple companies (a parent plus child entities) can manage all of them from one login. Multi-tenancy is enabled by the BforeAI team - contact support to create your first child company.

## Switching tenants

When your organization has child companies, the company name at the top of the sidebar becomes a **switch tenant** control. Clicking it opens a menu with:

* Your parent company
* Each child company, sorted alphabetically
* **Add entity** (Admins only) - create a new child company
* **Organization overview** - the cross-tenant comparison page (see [Parent-company overview](/docs/console/platform-overview/parent-company-overview.md))

<figure><img src="https://805658693-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcO8fwtDPLlpySjcpjpC5%2Fuploads%2Fltoknu5CVIhQkRc24ozc%2Ftenant-switcher-cut.png?alt=media&amp;token=8da2c713-0797-46e5-9b24-a3875dedd91e" alt=""><figcaption></figcaption></figure>

Selecting a company switches the whole platform to that company's data. The selection persists across sessions and is synchronized across your open browser tabs.

When you are viewing data that belongs to a different company than the one selected, a warning banner shows "Showing data from {company name}".

## Adding a child entity

Admins can choose **Add entity** from the switch tenant menu. The "Add new child entity" dialog asks for the same details as company settings: name (required), VAT, email, phone, address, postcode, and time zone.

<figure><img src="https://805658693-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcO8fwtDPLlpySjcpjpC5%2Fuploads%2FZDZV9upBCHFy5KarFmO1%2Fimage.png?alt=media&amp;token=a316cebe-68c5-44a7-b940-bf4cd848d4df" alt=""><figcaption></figcaption></figure>

### Duplicate name error

If the name you enter is already in use, a message appears directly below the **Name** field inside the dialog. The dialog stays open so you can correct the name and try again.

## Organization overview

The **Organization overview** page ("Parent company overview") shows one row per tenant so you can compare activity across your organization. See [Parent company overview](/docs/console/platform-overview/parent-company-overview.md).

## Limits when working in a child tenant

Some actions are restricted while switched into a child company. For example, you cannot create API keys on behalf of a child company - switch back to your own company first.


---

# 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 dynamically by asking a question.

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

```
GET https://docs.bfore.ai/docs/console/introduction/multi-tenant-organizations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.