0 / 0
Importing or exporting categories

Importing or exporting categories

You can import categories from a file that is in CSV format. You can also export categories to a file that is in CSV format. You can modify this file outside of the catalog and later import it.

Importing categories

Whether you can import a category depends on the level of the category, your user permissions, and in some cases, on your role within the parent category.

Required permissions

You must have this user permission to import top-level categories:

  • Manage governance categories

You must have one of these category roles on the parent category to import subcategories:

  • Admin
  • Owner
  • A custom role with the permission to import categories.

When you import a category, you become its only collaborator with the owner role. Imported categories do not have the Public access group assigned by default. Modify collaborators and their category roles after the import. When you add the Public access group to an imported category, it has the Editor category role assigned by default, as opposed to the Viewer role which is assigned to this group in case of manually created categories.

To import categories, see Importing governance artifacts.

Exporting categories

Whether you can export all top-level categories (with or without their subcategories) depends on your user permissions and in some cases, on your role within the parent category.

Required permissions
You must have this user permission to export categories:
  • Access governance artifacts

You must have one of these category roles to export categories:

  • Any predefined category role.
  • A custom role with the permission to export categories.

To export categories:

  1. Go to Governance > Categories.
  2. Click the export categories (export categories icon) icon.
  3. You can export all categories at the root level, either with or without their subcategories. To include the subcategories, select the respective option.
  4. Click Export.

The resulting all-category-csv-export.csv file is written to your default download folder. The file contains the following columns:

Name
The name of the root category.
Artifact Type
The artifact type category.
Category
The name of the subcategory if you included subcategories. For nested subcategories, it's the category hierarchy path without the top-level category.
Description
The description of the category if specified.
Tags
Any tags on the category. This information is stored internally and not visible in the UI.
Stewards
The stewards on the category. This information is stored internally and is not visible in the UI.
Steward Groups
The steward groups on the category.
Reporting Authorized
Setting for reporting on category metadata.

Learn more

Parent topic: Categories

Generative AI search and answer
These answers are generated by a large language model in watsonx.ai based on content from the product documentation. Learn more