> ## Documentation Index
> Fetch the complete documentation index at: https://octanist.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Multiple organizations

> Create and switch between several Octanist organizations, and use a parent organization with a portfolio dashboard, shared integrations, shared form mappings and lead routing for multi-location businesses.

An organization is one Octanist workspace with its own leads, integrations, settings, team and subscription. You can belong to several organizations, for example one per brand, website or client.

## Choose the right setup

| Situation | Setup |
| - | - |
| One business with one website | One organization. |
| Several separate businesses or brands | One organization each. Switch between them with the organization switcher. |
| An agency managing clients | Join the [partner program](https://octanist.com/docs/partners/agency-partner-program.md). Clients [link their organization](https://octanist.com/docs/partners/link-an-agency.md) to your agency. |
| One business with several locations or franchises that share a website or ad accounts | A [parent organization](#parent-organizations) with a child organization per location. Ask Octanist to set this up. |

## Switch organizations

Click the organization name at the top of the app to open the organization switcher.

* **Organizations** lists the organizations you belong to. A partner agency's own organization has an **Agency** badge.
* **Clients of** followed by an agency name lists client organizations you can open through that agency.
* **Organization overview** opens a list of all your organizations and any open invitations.
* **Add organization** creates a new organization.

Settings, integrations and leads always belong to the organization that is open.

## Create an organization

1. Open the organization switcher and click **Add organization**.
2. Enter the **Organization name** and **Website URL**.
3. Choose the **Default currency**, the **Default phone country** and the **Timezone**. The timezone starts at your browser's timezone.
4. Check **I accept the data processing agreement**.
5. Click **Create organization**.

Then install tracking for the new website. See the [Quickstart](https://octanist.com/docs/quickstart.md).

> [!NOTE]
>
> Each organization normally has its own subscription. See [Billing and plans](https://octanist.com/docs/settings/billing-and-plans.md).

## Parent organizations

A parent organization groups several child organizations, such as the locations of one business. Octanist sets up the parent and child relationship for you. Contact Octanist to set it up; the portfolio dashboard is available on request.

What a parent organization adds:

### Portfolio dashboard

In the parent organization, the dashboard shows a **Single** and **Portfolio** switch. With **Portfolio**, you see the numbers of several organizations together and can choose which organizations to include.

### Shared integrations

When Octanist turns this on for a child organization, it uses the parent's integrations. For each ad platform or analytics integration the child doesn't have itself, Octanist uses the parent's active integration of that type. This works for Google Ads, Meta, Microsoft Ads, LinkedIn, Snapchat, TikTok, Google Analytics 4, Server Container (GTM) and BigQuery.

Conversions from the child then use the parent's mappings:

* Qualified leads use the parent's qualified event.
* All won events use the parent's default won event.
* Form submission and phone call conversions use the parent's mapping, and only fire when the switch is on in the child's [Conversions](https://octanist.com/docs/settings/conversions.md#new-leads) settings.

An integration the child connects itself always takes priority over the parent's.

### Shared form mappings

When a child organization receives a form that it hasn't mapped itself, Octanist uses the parent's mapping for the same form. A mapping in the child takes priority.

### Lead routing

When several locations share one website, the parent can route leads to the right child organization based on a form field, such as a "Location" dropdown. A lead whose field value matches a routing rule goes to that child organization, together with the visitor's session, so attribution moves with it. Leads without a match stay in the parent. Contact Octanist to set up routing rules.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.