> For the complete documentation index, see [llms.txt](https://help.basespace.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.basespace.illumina.com/collaborate/workgroups.md).

# Workgroups

A workgroup consists of users who share data, storage, and other resources.

Workgroups belong to a domain. A domain holds the users and workgroups of an organization. An enterprise domain is identified by a URL prefix, such as `your-domain.basespace.illumina.com`, and can have many workgroups and users. The public domain, at `basespace.illumina.com`, holds the BaseSpace Free Trial, Basic, and Professional accounts. For how domains and workgroups work, see [Domains and workgroups](https://help.bioinsight.illumina.com/account-management/domains-and-workgroups).

{% hint style="info" %}
Users in your workgroup can incur costs related to data storage, compute, and analysis. To share project and run data only, use the Get Link or Share options. For more information, see [Share and Transfer Data](https://help.basespace.illumina.com/collaborate/share-with-collaborators.md).
{% endhint %}

## Owners and Administrators

Each workgroup has an owner and can have several workgroup administrators. The owner cannot be removed from the workgroup. Administrators can modify workgroup settings and add or remove users in the Admin Console. See [Manage Workgroups](#manage-workgroups).

An enterprise domain has a domain owner and can have several domain administrators. Domain administrators can create multiple workgroups, set an owner for each workgroup, and assign multiple workgroup administrators. Domain administrators can access and administer any workgroups in the domain. See [Manage Enterprise Domain](https://help.basespace.illumina.com/manage-your-account/manage-enterprise-domain.md).

For the account types that include workgroups, see [Account Types](https://help.basespace.illumina.com/overview/account-types.md).

## Switch Between Personal and a Workgroup

You switch between your personal context and your workgroup contexts with the context control in the top right corner of the page. In your personal context, the control shows Personal. In a workgroup context, it shows the workgroup name.

1. Select the context control.
2. Under Workgroups on current domain, select Personal or a workgroup.

![The context control open, listing Personal and the workgroups on the current domain](https://330234082-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg3bE5PSqw4Kkyc9yUsgB%2Fuploads%2Fgit-blob-0cf274c32216615f04dcd4de693ee7c76295683a%2Fworkgroup-context-menu.png?alt=media)

When you work in a workgroup context, you work with the workgroup’s data, settings, and resources. They are different from those in your personal context.

To choose where new uploaded runs go by default, use Default location for uploaded runs on the Account Overview tab of Settings in the left navigation.

## Collaborative Workgroups

Collaborative workgroups are available in enterprise domains. The public domain has none. In a collaborative workgroup, users from other domains can be invited. You choose Allow collaborators outside of this domain when you create the workgroup, and you cannot change that setting afterward. To create a workgroup, see [Manage Workgroups](#manage-workgroups). For how collaborative workgroups affect delivering data to another domain, see [Deliver Runs and Projects](https://help.basespace.illumina.com/collaborate/share-with-collaborators/deliver-runs-and-projects.md#deliver-to-another-domain).

## Manage Workgroups

You manage workgroups in the Admin Console. For the steps to create a workgroup, add or remove users, change a user's role or application access, and change the workgroup owner, see [Workgroups](https://help.bioinsight.illumina.com/account-management/admin-console/workgroups) in the Admin Console documentation. For who can do what, see [Owners and Administrators](#owners-and-administrators).

To revoke a workgroup invitation sent to someone who is not a registered user of BaseSpace Sequence Hub, email Illumina Technical Support. See [Technical Assistance](https://help.basespace.illumina.com/overview/technical-assistance.md).

### Open the Admin Console

Select your user icon in the top right corner of the page, and then select Admin Console. You can also select Settings in the left navigation, and then select Manage Workgroups on the Account Overview tab.

The Admin Console option and the Manage Workgroups link appear if you are a domain administrator, or while you are working in a workgroup that you own or administer. In your personal context, they do not appear unless you are a domain administrator. To switch to a workgroup, see [Switch Between Personal and a Workgroup](#switch-between-personal-and-a-workgroup).
