Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Case tagging

Updated on December 16, 2021
Applicable to Theme Cosmos and Cosmos React applications

You can use tags to classify, manage, and report on tagged cases in a preferred way. Using tags promotes flexibility and collaborative case management.

For example, in a financial application, you can create the tags premium and loan to flag cases related to specific types of accounts, or tags to flag specific types of issues, for example, customer_satisfaction.

The tags widget showing tags that are associated with a case
The tags widget listing tags that are associated with a case.
Note: For applications that you build with the traditional Theme UI-Kit, see Tagging a case.
You can create an initial list of tags for your application, to provide end users with tagging suggestions. The list helps end users find and apply the most often used tags and promotes consistent tagging throughout the application. For more information, see Creating suggested tags for cases.

Enabling tags for a case type and creating the initial set of tags
An initial set of five tags, to help ensure consistency in tagging.

At run time, you can tag cases by using existing tags or by adding new tags. You can tag a case regardless of the current case status. For more information, see Adding tags to cases at run time.

Selecting tags from different categories
The Manage tags section has three different categories: Added, Suggested, and Recently used by me.

You can gather relevant information faster by filtering tagged cases in several ways, for example, by recently added, recently viewed, or most frequently used tags. For more information, see Filtering tagged cases.

Filtering cases with a selected tag
The Tags navigation page with one tag selected and the cases that use that tag listed.

Adding tags to cases at run time

Find relevant information faster and enhance collaboration on cases by associating tags with cases.

For example, in an insurance application, you can add tags such as premium or high_risk to convey vital information about a case.
Note: For applications that you build with the traditional Theme UI-Kit, see Tagging a case.
Before you begin:
  1. Ensure that your application can use Theme Cosmos. For more information, see Enabling Cosmos React UI for landing pages.
  2. Enable case tags so that tagging is available at run time. For more information, see Enabling case tags.
  3. Add the Tag custom page to the navigation menu of the end-user portal, to enable searching for tags on the Tag landing page. For more information, see Organizing the main navigation for a portal and Custom pages.

At run time, you can add tags to a case by selecting from a list of available tags or by creating new tags. For more information about creating a set of default suggested tags for cases, see Creating suggested tags for cases.

You can tag a case regardless of its current status.

  1. Log in to an end-user portal, for example User Portal.
  2. Open a case:
    • Search for the case.
    • Click on the case in the worklist or work queue on your dashboard.
  3. In the Summary pane of the case, click Actions Manage tags.
  4. In the Manage Tags dialog box, select a tag from the list of existing tags or enter a new tag name, for example Reports.
    Note: Tags cannot contain spaces and are limited to 64 characters.
    Tip: You can also add tags by clicking items in the Tags recently used by me section of the dialog box.
  5. Click Add.
  6. Optional: To add more tags, repeat steps 4 to 5.
  7. Optional: To remove a tag association from a case, in the Manage Tags dialog box, click the Unlink this tag icon next to the tag that you want to remove.
  8. Close the dialog box.
    Result: The tags that you add appears in the Tags widget, in the associated tags list:
    List of tags associated with your case
    The Tags widget listing tags that are associated with your case.
    Note: You can now manage case tags by clicking the Manage tags icon, and then adding or removing tags.
What to do next: To improve case search, ensure that users apply consistent tagging by creating suggested tags. For more information, see Creating suggested tags for cases.

Filtering tagged cases

Use tags to search, access, and report on cases faster. You can filter tagged cases in several ways, for example, by viewing only the recently added or most frequently used tags. To find specific information, you can also create specific tags and then search cases with those tags.

For example, you can look for cases with the premium tag to identify your key clients or accounts.
Note: For applications that you build with the traditional Theme UI-Kit, see Tagging a case.
Before you begin:
  1. Ensure that your application can use Theme Cosmos. For more information, see Enabling Cosmos React UI for landing pages.
  2. Enable case tags so that tagging is available at run time. For more information, see Enabling case tags.
  3. Add the Tag custom page to the navigation menu of the end-user portal to enable searching for tags on the Tag landing page. For more information, see Organizing the main navigation for a portal and Custom pages.
  1. Log in to an end-user portal, for example, User Portal.
  2. In the navigation pane on the left, click Tags.
  3. Search for cases in one of the following ways:
    • To filter cases by a specific tag, enter the tag name in the Search field, and then select the tags from the Search results section.
    • To filter cases by tags that you added recently, select the tags from the Recently added by me section.
    • To filter cases by tags that any other user added recently, select the tags from the Recently added by anyone section.
    • To apply more out-of-the-box filters that categorize tags, click the Filter icon next to the Search field, and then select any of the available options, for example, Recently viewed by me.
    Result: The Selected tags section displays cases that use the selected tags. You can now preview the cases by clicking the case names.
    Note: If your tags also appear in any Pulse messages, the search results provide this information on the Posts tab.
    Filtering cases by the premium tag
    The Tags navigation page with one tag selected and the cases that use that tag listed.
  4. Optional: To add more tags to filter cases that use any of the selected tags, in the Selected tags section, click Edit to enter or select more tags in the search box, and then click Apply.

Creating suggested tags for cases

Improve case search and ensure that users apply consistent tagging by creating suggested tags. When users apply consistent tagging in cases, they obtain information that they need faster. By defining sets of suggested tags you shorten case processing time as users can select tags from a list when they tag a case instead of typing tags manually.

Before you begin:
  1. Ensure that your application can use Theme Cosmos or Cosmos React. For more information, see Enabling Cosmos React UI for landing pages and . For applications that you build with the traditional Theme UI-Kit, see Creating suggested tags for cases.
  2. Enable case tags. For more information, see Enabling case tags.
  1. In the navigation pane of App Studio, click Case types, and then click the case type that you want to open.
  2. Click the Settings tab, and then, in the navigation pane, click Collaboration.
  3. In the Tags section, in the Configure tags field, enter a tag that you want to create as a suggested tag, and then click Add.
    Note: Tags cannot contain spaces and are limited to 64 characters.

    Tags can use underscores, so a tag with multiple words can be written as customer_satisfaction.

    For example: The following figure shows tags that are now in the list of suggested tags for every case in a given case type:
    Suggested tags for a case type
    Tags added to the list of suggested tags for a case type.
  4. Optional: To remove a tag from the list of default tags associated with a case type, click Remove next to the tag.
  5. Click Save.
Result: At run time, when users tag a case, they can select the suggested tags, instead of entering tags manually:
A case with a list of suggested tags
A case with a list of suggested tags that you can add to your case.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us