Creating a category

Whether you can create or manage a category depends on the level of the category, your user permissions, and on your role within the parent category.

Restrictions

You have these restrictions when you create categories:

• The combination of the category path plus its name must be unique.
• Category names cannot contain the >> characters because they are used to specify the hierarchy path, for example, primary category >> subcategory.
• You can't create a subcategory to the [uncategorized] category.
• The maximum number of categories that a user can be assigned to (either directly, or via the user group) is 10000. If you assign more categories to the user, some of them and their associated artifacts might not be displayed correctly.

Some IBM Knowledge Catalog plans have additional limits on the number of categories that you can create.

Moving a category

You can move a category to any other category or to the top level. When you move a category, you are also moving all its subcategories. The collaborators that were added to this category are also moved if they have the required permissions to access the new parent category. The collaborators that were inherited from the original parent category are not moved, you can add them manually when the category is moved.

Required permissions

You must have both user permissions and category collaborator roles to move a category:

• You must have one of these user permissions:
  • Access governance artifacts
  • Manage governance categories
• You must also have one of these category collaborator roles in the parent category:
  • Admin
  • Owner

Restrictions

You can't move a category to its subcategory, to [uncategorized], or to a category that already has a subcategory with the same name.

To move a category, open it and select Move to from the action menu next to its name.

Editing a category

You can edit these category properties:

• The category name. Select Rename from the action menu next to the category name.
• The description. Click the edit icon next to the description in the About this category pane.

You can add or remove collaborators in the About this category pane or the Access control page.

Also, you can add or remove tags in the About this category pane.

On the Content tab, you can add subcategories and governance artifacts and, if available, you can edit custom attributes.

Required permissions

You must have a combination of user permissions and category collaborator roles to edit category properties:

• You must have one of these user permissions:
  • Access governance artifacts
  • Manage governance categories
• You must also have one of these category collaborator roles in the category:
  • Admin
  • Owner

Restrictions

You can't rename the [uncategorized] category.

You can't change a category's parent category.

Deleting a category

Before you can delete a category, you must delete or move all the primary artifacts from the category and from its subcategories and then delete its subcategories. You can't delete the [uncategorized] category.

Required permissions

You must have a combination of user permissions and category collaborator roles to delete a category:

• You must have one of these user permissions:
  • Access governance artifacts
  • Manage governance categories
• You must also have the Owner role in the category, or a custom role with the permission to delete categories.

To delete a category, open it and select Delete from the action menu next to its name.

Changing the primary category of an artifact

You can change the primary category of the published artifacts at any time.

Required permissions

You must have one of these roles in both the original and the new primary categories to change the primary category for an artifact:

• Admin
• Owner
• Editor
• A custom role with the permission to edit a specific artifact type.

To change the primary category of a single artifact:

1. Open the selected artifact page.
2. From the overflow menu select Move to.
3. Select the new category and click Move.

To change the primary category of multiple artifacts of the same type at once:

1. Select the artifacts from the list and click Edit > Primary category.
2. Select the new category and click Save.

Adding or changing secondary categories for artifacts

You can add secondary categories to either draft or published artifacts.

Required permissions

You must have one of these roles in both the primary category of the artifact and the secondary category that you want to add or remove:

• Admin
• Owner
• Editor
• A custom role with the permission to edit a specific artifact type.

To add one or more secondary categories to an artifact, go to the artifact's detail page and click the plus icon next to Secondary categories. Select one or more categories and click Save.

To remove a secondary category from a draft or published artifact, open the artifact and click Remove from the menu next to the secondary category name.

You can add one or more secondary artifacts of a specified artifact type to a category. To add one or more secondary artifacts to a category, open the category and click Add to category. Select the artifact type, and then select one or more artifacts and click OK.

To remove a secondary artifact from a category, open the category and click Remove from the menu next to the secondary artifact name.

Learn more

• Designing categories
• Managing category collaborators
• Category collaborator roles
• Importing and exporting categories

Parent topic: Categories