Skip to main content
Version: 2.0 🆕

Manage Categories

Categories help you group and classify both clusters and environments based on your organization’s standards. Teams commonly use categories like prod, QA, dev, or stage for quick filtering and visual clarity across the Devtron UI. This page guides you through creating, updating, and deleting categories, along with the rules that govern naming and usage.

Add Category

Before assigning a category, you must first add the category. To add a category, follow the steps below:

  1. Go to Global Configurations.

    Figure 1: Navigating to Global Configurations

  2. Select Clusters and Environments and click Manage Categories, a modal window will open.

    Figure 2: Clicking Manage Categories

  3. Enter the name of the category in the CATEGORIES field and provide a description in the DESCRIPTION field.

Note:
  • The category name must be unique and cannot be changed once defined. It should be a minimum of 3 characters.
  • It can contain alphanumeric characters, but cannot start with a number.
  • The name should be in lowercase only.

Figure 3: Adding Category

  1. If you wish to add more categories, click Add Category, a new row will appear, enter the name and description of the new category.

    Figure 4: Adding More Categories

  2. Click Update and your categories will be added.

    Figure 5: Categories Added

Delete Category

To delete a category, follow the steps below:

  1. Go to Global Configurations.

    Figure 6: Navigating to Global Configurations

  2. Select Clusters and Environments and click Manage Categories, a modal window will open.

    Figure 7: Clicking Manage Categories

  3. Select the x icon next to the categories you want to delete.

    Note: You cannot delete a category if it is assigned to a cluster or environment.

    Figure 8: Clicking 'x' icon

  4. Click Update to delete the categories.