Bulk business unit management

Bulk update business unit assignments for domains and IP ranges using a CSV file.

You can update Business Unit (BU) assignments for multiple assets at once by uploading a single CSV file. This bulk import eliminates the need to manually edit assets one by one in the UI, saving time and reducing administrative overhead. To update BUs in bulk, you’ll prepare a CSV file that specifies each asset, its type, the target BU, and the desired action. The system supports both append (adding new BUs to existing BUs) and replace (overwriting all existing BUs) actions.

During the upload, the system automatically validates each row before processing. Valid entries are executed immediately, while invalid rows are rejected with actionable error messages. When the operation is complete, a detailed status report tracks the success or failure of each row. This granular tracking allows you to review the results, troubleshoot issues, and retry failed entries without needing to reprocess the entire dataset.

Bulk BU updates are supported for domains and IP ranges.

Prerequisites for bulk BU management

• You must have Admin role permissions.
• The BUs you reference in the CSV must already exist in your Xpanse tenant.
• The assets (domains or IP ranges) you reference must already exist in your Xpanse inventory.

CSV format for bulk BU updates

Example CSV for bulk BU updates

This example shows the correct CSV format for a bulk BU update, including the supported values for asset types and supported IP range notation. The headers in your CSV must match the headers as they are shown here.

Asset	AssetType	BusinessUnits	ActionType
example.com	Domain	BU_Name1	APPEND
example.org	Domain	BU_Name2	APPEND
example.org	Domain	BU_Name3	REPLACE
8.8.8.8-8.8.8.24	IP_RANGE	BU_Name4	APPEND
192.0.2.1	IP_RANGE	BU_Name5	REPLACE

CSV details for bulk BU updates

This table provides additional details about the information required in each column of the CSV for bulk BU updates. Note that the CSV can include a maximum of 50 entries.

Column	Description
Asset	The asset name, either a domain name or IP range. For domains, use the fully qualified domain name (e.g., example.com, api.example.com). Note: when you update BUs on a domain via bulk upload, the change does not propagate to its subdomains. If you need subdomains updated too, include them as separate rows in the CSV. For IP ranges, use the following formats: 192.168.1.0/24 10.0.0.1-10.0.0.255 192.0.2.1 (for a single IP address)
AssetType	Supported values are DOMAIN or IP_RANGE.
BusinessUnits	The BU to assign, either a BU name or BU:<id>. The BU must already exist in your Xpanse tenant. List only one BU per row.
ActionType	Use APPEND to add to existing BUs, or REPLACE to overwrite all BUs.

How to update the BU for assets in bulk

1. Prepare your CSV file using the instructions in the CSV format for bulk BU updates section. The CSV can include a maximum of 50 entries.
2. Navigate to Settings > Configurations > Asset Management > BU Management.

This opens the Bulk BU Updates page, which lists all previous bulk BU updates along with the status and other information.

1. Click Update Business Units and select Add/Remove Business Units(s) from Asset(s).

From the Business Units to Update dialog box, you can download a complete list of the BUs in your system and a sample CSV file.

1. Upload your CSV file, then click Update Business Units.
2. After the CSV has been processed, you can check the status on the Bulk BU Updates page. Every row from your CSV upload is tracked in the system with one of three statuses:

Status	Description
Pending	The row has been accepted and is queued for processing.
Success	The BU update was applied to the asset.
Failure	The update could not be applied. Check the error message for details.