> For the complete documentation index, see [llms.txt](https://knowledge.illumina.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledge.illumina.com/software/basespace-sequence-hub/software-basespace-sequence-hub-reference_material-list/000001666.md).

# How to share BaseSpace Sequence Hub data between the public and private domains

[BaseSpace Sequence Hub](https://www.illumina.com/products/by-type/informatics-products/basespace-sequence-hub.html) (BSSH) is the Illumina cloud-based platform for data management, storage, and analysis.

For users who signed up for a BSSH subscription prior to August 4, 2026, there are three subscription tiers - Basic, Professional, and Enterprise. Basic and Professional subscriptions are hosted on the public domain; whereas, Enterprise subscriptions are hosted on a private domain.

For users who sign up for BSSH as of August 4, 2026, creating a new account creates a new private domain, or a new user must be invited to a private domain. See this [Getting Started](https://help.connected.illumina.com/getting-started) page for more details.

Run or project data in BSSH can be shared between public and private domain users through the use of a [collaborative workgroup](https://help.connected.illumina.com/account-management/admin-console/workgroups) on the private domain. This article describes how a private domain admin can create a collaborative workgroup to allow data sharing between public and private domain BSSH accounts.

**Note**: In the example image below, the placeholder email (<admin@domain.com>) is used for illustrative purposes. Users must use their respective domain email address.

**Creating a collaborative workgroup (private domain)**

The administrator of the private domain must create a collaborative workgroup within their domain:

* Navigate to the [Admin Console](https://help.connected.illumina.com/account-management/admin-console).
* Select **Workgroups** and **+ Create Workgroup**.\
  ![](/files/cgpbyYk0z0uEaUaHGUyP)
* Enter the information in the required fields.
* Under the Collaboration section, select "Allow collaborators outside of this domain".\
  ![](/files/DHH88JGtsMBv7SD1HNAP)
* Select **Create workgroup**.
* Confirm the workgroup creation by navigating to BSSH and selecting the button labeled Personal with 9 dots in a grid next to it and then **< Switch Workgroup**

  ![](/files/vG4BtI5MjtGMbNunLXkJ)
* The newly created collaborative workgroup will be present in the **Workgroups on current domain** list.

  ![](/files/BIGTLZ1J0iacJ9gS2r89)

**Sharing data between domains**

**Notes**:

* For sharing data from a private domain to the public domain, the owner of the data on the private domain must have the data they intend to share in a collaborative workgroup. If the data are not in a collaborative workgroup, they must be [transferred](/software/basespace-sequence-hub/software-basespace-sequence-hub-reference_material-list/000009086.md) to that workgroup first.
* For sharing data from the public domain to a private domain, the public domain user can share directly from their Personal account.
* To share the data, the initiating user must create a [share link](https://help.connected.illumina.com/basespace/collaborate/share-with-collaborators/share-by-link), and not share by email. That share link must then be sent to the receiving user.
  * Note: Also use this option for runs stored in Illumina BioInsight Platform Core (formerly, Illumina Connected Analytics (ICA)).
* The receiving user must be logged into their BSSH account before using the link. If the receiving user is a private domain user, they must change to their collaborative workgroup before proceeding.
* The receiving user must copy the share link, and then from within BSSH paste the link into the address bar of the web browser.
* A confirmation window will appear and ask the receiving user to select the **Context to accept invite.**
  * Public domain users select Personal, then **Accept.**
  * Private domain users select the collaborative workgroup from the dropdown menu, then **Accept.**
* A "Share Accepted" notification will display in the bottom right corner of the web browser. The receiving user can select that link to navigate to the shared data, or navigate to the Runs or Projects section to access the data.

**Resolutions to possible issues**

* If the receiving user opens the share link without being logged into their own BSSH account first, they will be prompted to log into the sender's domain and will receive the message "**User is not a member of selected domain**". To resolve, the receiving user must log in to their account first, then copy and paste the share link into the address bar of their browser.
* If the receiving user is on a private domain and tries to accept the share into their Personal space or a non-collaborative workgroup they will receive the message "**Data can not be shared across different domains, unless using a collaborative workgroup**". To resolve, accept the share in the context of the collaborative workgroup.

\
\
\ <br>

|                                                                                                                                                                                                                                                                                                                                                                 |
| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| *For any feedback or questions regarding this article (Illumina Knowledge Article #1666), contact Illumina Technical Support* [*techsupport@illumina.com*](mailto:techsupport@illumina.com?subject=Question%2FFeedback%20Regarding%20Illumina%20Knowledge%20Article%20#000001666%20-%20Software%20\&body=Dear%20Illumina%20Technical%20Support,%0D%0A%0D%0A)*.* |


---

# 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://knowledge.illumina.com/software/basespace-sequence-hub/software-basespace-sequence-hub-reference_material-list/000001666.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.
