Cisco
Login
Search
Software Secure Workload
Activity Configure

Manage Inventory for Secure Workload Workload Labels Importing Custom Labels Upload Custom Labels

Last updated: Jun 09, 2025

Upload Custom Labels

The following steps explain how users with Site Admin, Customer Support or a root scope owner role can upload labels.

Before you begin

To upload the custom labels, create a CSV file according to the ‘Guidelines for Uploading Label Files’ section.

Procedure

1

In the left pane, select Organize > User Defined Label Upload > CSV Upload, and then under Upload New Labels, click Select File.
2

In the left pane, select Organize > Label Management, and then under Upload New Labels, click Select File.
3

Select the operation-Add, Merge, or Delete.

  • Add: Appends labels to new and existing addresses/subnets. Resolves conflicts by selecting newer labels over existing ones. For example, if labels for an address in the database are {"foo": "1", "bar": "2"} and the CSV file contains {"z": "1", "bar": "3"}, add` sets labels for this address to {"foo": "1", "z": "1", "bar": "3"}.

  • Merge: Merges labels to existing addresses/subnets. Resolves conflicts by selecting non-empty values over empty values. For example, if labels for an address in the database are {"foo": "1", "bar": "2", "qux": "", "corge": "4"} and the CSV file contains {"z": "1", "bar": "", "qux": "3", "corge": "4-updated"}, merge` sets labels for this address to {"foo": "1", "z": "1", "bar": "2", "qux": "3", "corge": "4-updated"}.


     

    Value of “bar” in not reset to “”(empty), instead existing value of “bar”=”2” is preserved.

  • Delete: This option removes labels for an address/subnet, which can significantly impact scopes, filters, policies, and enforced behavior. For important details, see Delete Labels.

Important: The Delete function, while uploading the custom labels, will remove ALL labels associated with the specified IP addresses/subnets, and is not limited to the columns listed in the CSV file. Therefore, the Delete operation must be used with caution.
4

Click Upload.
Previous topic Label Key Schema Next topic Search Labels