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

# Import groups

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

When performing a bulk import of groups:

- The header row contains only one column with Name as the value
- Every data row must have an existing Identity as a Service group name

## CSV file format

The following is a sample CSV file to help you get started:

```csv
Name
Group1
Group2
Group3
Group4
```

Download a sample file: [ImportGroupSample.csv](/assets/files/ImportGroup-3c802a228467e53d0d2038d7e0a29420.csv/)

## Group import attributes

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

**Table: Bulk import groups**

| Attribute | Description                                                               | Header Value | Required |
| --------- | ------------------------------------------------------------------------- | ------------ | -------- |
| NameName  | This is the only required column. Every data row must have a group name.. | Name         | Yes      |

## Bulk import groups

## How to bulk import group

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 **Groups**.
4. From the **Actions** drop-down list, select **Import**.
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. Click **Upload your CSV file** and browse to select the bulk operations file.
10. Click **Initiate and Upload**.
11. The **Start/Stop** dialog box appears.
12. Click **Start**. When the upload completes, a **Finished** prompt appears.
13. Click **Finished**. You are returned to the **Bulk Operations List** page. Your bulk operation appears in the **Bulk Operations** page.
14. To see a summary of the upload, click Play icon to view the details of the bulk operation, including any error information.
15. 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.
16. 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.
17. Click Play icon to view the details of the bulk operation.