> 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/illumina-connected-multiomics-icm/software-illumina-connected-multiomics-icm-reference_material-list/000010147.md).

# How to add a User to Illumina Connected Multiomics (ICM) Domain and Workgroup

**Step 1: Invite the User to the ICM Domain**

1. A user with a domain admin account will need to add users from the **Admin Console** tab. To access Admin Console without going through a workgroup, use the following link, with the domain placeholder updated: https\://\<domain>.login.illumina.com/iam/. The resulting Admin page will display the list of workgroups on the domain.\
   ![](https://761066130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGM9W2DuBTgEXv1ClCm8H%2Fuploads%2Fgit-blob-cff4260c7cddef257a6a5a2cc83743a01bd84865%2Fimage1.png?alt=media)
2. Select the **Domain** tab on the left panel to access the Domain settings. From there, navigate to **User Management** option on the second-to-left panel. Ensure that the user that is intended to be added is included in the **Allowed Emails** section either by:

* Adding the user's email domain to the **Allowed Email Suffixes**, or
* Explicitly specifying the user's email in the **Allowed Emails** section.\
  ![](https://761066130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGM9W2DuBTgEXv1ClCm8H%2Fuploads%2Fgit-blob-dbaf8eb3ebb86c24455f35eb22a1a99bb13c83de%2Fimage2.png?alt=media)

**Note:** If the domain admin chooses to add an email suffix, any user with that email suffix will be able to register under the domain (without receiving a domain invitation).

3. Once confirmed that the intended user's email address is allowed, select the **Users** tab, then select the '**+ Invite**' option, and type in the e-mail address of the user to invite to the domain, then select **Invite to domain**.

![](https://761066130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGM9W2DuBTgEXv1ClCm8H%2Fuploads%2Fgit-blob-eaee1d02ad85d62aedf7d05be27d7902885b5bfb%2Fimage3.png?alt=media)

![](https://761066130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGM9W2DuBTgEXv1ClCm8H%2Fuploads%2Fgit-blob-0f1f2fbf729cabb2230f08bc490b8ccb89d7a5d1%2Fimage4.png?alt=media)

4. The added user will receive an email and should follow the instructions in the invitation to register an account under the domain. Advise users to log out of other platforms in the public domain (such as BaseSpace Basic or Professional accounts) when completing this step.

**Note**: The domain administrator can verify the successful registration of the invited user in the Admin Console. Select the **DOMAIN** tab on the top of the dialog, select **USER MANAGEMENT** on the left panel, then select the **Users** tab on the User Management page. Select the **Manage** button. The user state information will be displayed at the bottom of the page.

**Step 2: Invite the User to the ICM Workgroup**

1. Domain or workgroup admin can add users to the ICM workgroup. From the Admin Console, go to the **Workgroups** tab in the left panel, and select the ICM workgroup.\
   ![](https://761066130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGM9W2DuBTgEXv1ClCm8H%2Fuploads%2Fgit-blob-a0b6233c4e8e78d77496a85b36dae9ee26332ea8%2Fimage5.png?alt=media)

Navigate to **Users** tab on the top, and select '**+ Invite**'.\
![](https://761066130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGM9W2DuBTgEXv1ClCm8H%2Fuploads%2Fgit-blob-2c1413daf3d83ea083b8d4664f08979ab16af7b5%2Fimage6.png?alt=media)\
2\. Type in the user's email and select **Invite to workgroup**.

The user will receive an email that they are added to workgroup.

**Step 3: Assign the User an ICM subscription Seat**

After adding the user to the ICM domain and workgroup, a domain admin will need to assign the user’s email to the ICM subscription to allow access.

1. Navigate to **Subscriptions** and select **Assign** under **Emails** of the ICM Subscription.
2. Type in the user email. If an email is already assigned to the ICM subscription, the domain admin can remove the pre-existing email by selecting the X then add the user's email.

![](https://761066130-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGM9W2DuBTgEXv1ClCm8H%2Fuploads%2Fgit-blob-02fce5099e75a5902a0a7dae6e1a09f9910d1c52%2Fimage3.png?alt=media)

Note that the subscription seat for ICM is designed to rotate between users.

\
\
\ <br>

|                                                                                                                                                                                                                                                                                                                                                                  |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| *For any feedback or questions regarding this article (Illumina Knowledge Article #10147), contact Illumina Technical Support* [*techsupport@illumina.com*](mailto:techsupport@illumina.com?subject=Question%2FFeedback%20Regarding%20Illumina%20Knowledge%20Article%20#000010147%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/illumina-connected-multiomics-icm/software-illumina-connected-multiomics-icm-reference_material-list/000010147.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.
