Create or modify custom Virtual Agent categories

  • Release version: Zurich
  • Updated July 31, 2025
  • 2 minutes to read
  • Create or change custom categories for organizing and grouping related Virtual Agent assets, such as topics. You can also make category labels visible in the Topic picker menu displayed to end users.

    Before you begin

    Role required: virtual_agent_admin or admin

    About this task

    Use topic categories to group related conversation topics. When your create or update a topic, you can assign one or more categories to which the topic belongs. You can also view your topics by category in Virtual Agent Designer.

    For your end users, you can make the custom category label visible in the Topic picker menu so that associated topics are displayed by category.

    Before you create a new category, review the existing categories (All > Conversational Interfaces > Virtual Agent > Categories) to determine if you need a new category.

    Note:
    Pre-built topics have associated, default categories that can't be changed or deleted. Also, you can delete a custom category only when the category does not have any topics assigned to it.

    Procedure

    1. Navigate to All > Conversational Interfaces > Virtual Agent > Categories.
    2. Select New to create a custom category or select a category record to change it.
      Field Description
      Name Label for the category.
      Description Brief description of the category purpose.
      Application Application scope of the category.
      Visible to end user Option to display the category label in the Topic picker menu for end users.
      Note:
      • If you upgraded from a previous release, existing category labels are set to not visible.
      • This option does not control the topics displayed within the category. At the topic level, use the Condition field in the Topic Properties page to set conditions that control when a topic is displayed to end users.
    3. Select Submit or Update.
      The topic category appears in the following items:
      • Category list collector (slushbucket) on the Topic Properties page in Virtual Agent Designer so that you can assign one or more categories to a topic.
      • Category filter on the Topics page, so that you can view topics by category.
      • Topic cards on the Topics page, for topics that have assigned categories.
      • Topic picker menu displayed to end users, if you made the category visible. Topics with multiple categories are displayed in the appropriate categories. Topics without categories are listed in the Others category.
        Figure 1. Topic picker menu
        Topic picker menu that shows topics organized by categories.
    4. To delete a topic category, open the category record and click Delete.
      If there are no topics associated with the category, the category is deleted. It is no longer listed in the Category field on the Topics Properties page and in the Category filter on the Topics page in Virtual Agent Designer.