> For the complete documentation index, see [llms.txt](https://help.bioinsight.illumina.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.bioinsight.illumina.com/account-management/domains-and-workgroups.md).

# Domains and workgroups

A **domain** is what your team signs in to on Illumina BioInsight Platform. It holds your team’s users, admin settings, and workgroups. A **workgroup** is a shared space inside a domain where your team works with data. You can also work in **personal context**, your own workspace in the domain.

## How domains and workgroups fit together

Your Illumina login (one email) is person-level. After you sign in, you work inside a domain membership and an active context:

* An Illumina user can belong to one or more **domains**.
* Each domain contains one or more **workgroups**.

**Personal context** is your individual workspace within a domain. Data and work there belong to you, not to a shared workgroup. Shared team collaboration happens in workgroups.

Membership has separate layers:

| Layer                               | What it controls                                                                                                                                             |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Domain membership**               | Whether you belong to the domain (for example as a domain administrator or user). Controls domain-wide admin access and who is inside the domain by default. |
| **Workgroup membership**            | Which workgroups you can open (for example workgroup administrator or member). Controls the shared data and collaboration spaces available to you.           |
| **Personal context**                | Your individual workspace in a domain. Not a shared workgroup.                                                                                               |
| **External / collaborative access** | Access to a workgroup without full domain membership. Used in collaborative workgroups, which let people from other domains join.                            |

{% hint style="info" %}
Domain membership and workgroup membership are separate. People from other domains who join a collaborative workgroup are workgroup members only. If an invited person’s email is on the domain’s allowed list, they join the domain and the workgroup together.
{% endhint %}

## Public (accounts) and private domains

Domains are either public or private, depending on the subscription:

| Kind               | What users see                                                                                                                                                  | Products                                               | Where the subscription and credits attach                                            |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------ |
| **Public domain**  | Domain named **accounts** (Illumina’s shared public domain)                                                                                                     | BaseSpace Free Trial and Basic; BaseSpace Professional | Free Trial and Basic: user-scoped. Professional: workgroup-scoped under **accounts** |
| **Private domain** | A named domain your team created (for example through sign-up or [Order Registration](https://help.bioinsight.illumina.com/getting-started/rg-registration.md)) | BioInsight Platform (Free Trial, PAYG, paid)           | Domain-scoped. Workgroups still hold data and collaboration inside that domain       |

{% hint style="warning" %}
BaseSpace Professional is **not** a private domain. It is a paid workgroup under the public **accounts** domain. BioInsight Platform uses a private domain.
{% endhint %}

## Switching domains

If your email belongs to more than one domain, the **Choose a domain** page appears when you sign in. Select a domain, and then select **Finish login**. Your most recently used domain is preselected.

## Roles

| Role                        | Scope                   | Responsibilities                                                                                                                                          |
| --------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Domain owner**            | Entire domain           | The primary administrator and main contact for the domain. The domain owner is automatically a domain administrator                                       |
| **Domain administrator**    | Entire domain           | Invite or remove domain users, manage domain settings, create and manage the domain’s workgroups, and set collaboration policy. A domain can have several |
| **Workgroup owner**         | One workgroup           | The user listed as the workgroup owner. The owner cannot be removed from the workgroup                                                                    |
| **Workgroup administrator** | One workgroup           | Manage that workgroup’s members and settings. A workgroup can have several                                                                                |
| **Member**                  | Domain and/or workgroup | Do scientific work in entitled apps                                                                                                                       |

For detailed admin steps, see [Admin Console](https://help.bioinsight.illumina.com/account-management/admin-console.md), [Workgroups](https://help.bioinsight.illumina.com/account-management/admin-console/workgroups.md), and [Domain](https://help.bioinsight.illumina.com/account-management/admin-console/domain.md). To create a domain, see [Getting Started](https://help.bioinsight.illumina.com/getting-started.md).

## Sharing and collaboration

* **Same domain:** Sharing within your domain is the default collaboration path. Domain users can be invited to workgroups according to your domain’s policies.
* **Outside the domain:** By default, a workgroup is limited to members of your domain. A domain administrator can create a collaborative workgroup by selecting **Allow collaborators outside of this domain** when creating the workgroup. See [Workgroups](https://help.bioinsight.illumina.com/account-management/admin-console/workgroups.md). You cannot change this choice after the workgroup is created, and it is not available in the public **accounts** domain. To change the domain’s collaboration settings, see [Domain collaboration](https://help.bioinsight.illumina.com/account-management/admin-console/domain.md#collaboration).

## Subscriptions and credits

Where subscriptions and BioInsight Credits (BIC) attach depends on the product model:

| Product context                          | Where subscription / credits attach                                               |
| ---------------------------------------- | --------------------------------------------------------------------------------- |
| **BioInsight Platform** (private domain) | At the private domain. Workgroups hold data and collaboration inside that domain. |
| **BaseSpace Free Trial and Basic**       | User-scoped under the public **accounts** domain.                                 |
| **BaseSpace Professional**               | At the Professional workgroup under the public **accounts** domain.               |

For billing and usage tracking, see [Software Billing](https://help.bioinsight.illumina.com/account-management/software-billing.md) and [Usage Explorer](https://help.bioinsight.illumina.com/account-management/usage-explorer.md).

## Region

A domain has one or more enabled data regions. A domain administrator can enable or disable regions in [Regions](https://help.bioinsight.illumina.com/account-management/admin-console/domain.md#regions).

## FAQ

### Is my company email domain the same as my BioInsight domain?

No. An email domain (for example `@acme.com`) is part of an email address. A domain can use email domains in its allowed email list and for SSO. Your BioInsight Platform domain is the domain you select when you sign in.

### I have BaseSpace Professional. Is that a private domain?

No. BaseSpace Professional is a workgroup under the public **accounts** domain. BioInsight Platform uses a private domain.


---

# 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://help.bioinsight.illumina.com/account-management/domains-and-workgroups.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.
