> For AI agents: [llms.txt](https://docs.trustedauth.com/llms.txt) provides a Markdown index of this documentation.

# Import users and groups

Use the Bulk import users and groups bulk operation to assign users to groups. Before you begin, review the information in [Bulk operations](/docs/perform-bulk-operations.md).

When performing a bulk import of users and groups:

The header row must only contain two headers: the User ID and Group Names separated by the delimiter you select when you perform the bulk import.

Each data row must list an existing user's User ID and a set of groups they are to be associated with. The groups must be identified by the group name.

You can include more than one group name with each user to associate a user to multiple groups in one import operation.

note

You can include more than one group name with each user to associate a user to multiple groups in one import operation.

## CSV file format

The following is a sample CSV file to help you get started. You can also download a sample file from the **Bulk Import Users/Group** page and then edit it to match your requirements.

```csv
User ID, Group Names
User1,group1,group2,group3
User2,group1,group3
User3,group1,group3,group4,group5
```

Download a sample file: [UserGroupSample.csv](/assets/files/UserGroup-d7893b40024820b86ec91583b5e8df6a.csv/)

## User/group attributes

The following table summarizes supported Identity as a Service user/group import attributes.

**Table: Bulk assign users to groups attributes**

| Attribute   | Header value | Required | Description                                                                                                        |
| ----------- | ------------ | -------- | ------------------------------------------------------------------------------------------------------------------ |
| User ID     | User ID      | Yes      | The User ID of the user. This value must be unique. If the User ID already exists, then the user record will fail. |
| Group Names | Group Names  | Yes      | The group or groups to be assigned to the user. Every data row must have at least one group name.                  |

## Bulk import users and groups

### How to bulk import users and groups

1. Click Menu icon **>** **Bulk Operations**. The **Bulk Operations** page appears.

2. Click Circle Plus icon. The **Add Bulk Operation** page appears.

3. From the **Operations** drop-down list, select **User/Groups**.

4. From the **Actions** drop-down list, select **Import**.

note
When you select the **Users/Groups** import operation, a sample file appears. You can download this file or copy it to the clipboard and then modify it as required.

5. Select the **File Delimiter** **Pipe (|)** or **Comma (,)**. The **File Delimiter type** identifies the character in your CSV file used to specify the boundary between each user or group name.

note
If a data field requires a delimiter value or white space, put quotation marks around that field. If you do not, the information will not import.

6. Set the **Maximum Number of Retries** to set the number of bulk import attempts if it is not immediately successful. The default value is 5. This setting prevents an endless number of retry attempts if the operation fails.

7. Enter a unique **Name** that identifies the operation in the **Bulk Operations List** page.

8. Enter a **Description** that describes the purpose of the operation.

9. Optional. Copy or download the same bulk file and modify it as required.

10. Click **Upload your CSV file** and browse to select the bulk operations file.

11. Click **Initiate and Upload**.

12. The **Start/Stop** dialog box appears.

13. Click **Start**. When the upload completes, a **Finished** prompt appears.

14. Click **Finished**. You are returned to the **Bulk Operations List** page. Your bulk operation appears in the **Bulk Operations** page.

15. To see a summary of the upload, click Play icon to view the details of the bulk operation, including any error information.

16. To download a log file of the import operation, click Cloud Download icon next to the name of your operation to download the log file.

17. Click Refresh CW icon in the **Refresh** column to refresh the status of a bulk operation. This option appears only when a refresh is available.

18. Click Play icon to view the details of the bulk operation.