Word groups for standard topics

Word groups enable faster and more robust topic building

A word group is a collection of synonyms or similar words that are identified by a handle (#). Use word groups to create one rule that applies to multiple keywords and build topics faster.

For example, suppose you need to build a topic called Staff Attitude. To create the topic without using word groups, you would need to create a list of 10 attitude words, then enter several new rules to describe the staff:

Individual rules
  • staff near friendly
  • staff near arrogant
  • staff near rude
  • staff near temper
  • staff near professional
  • staff near lazy
  • staff near kind
  • staff near mean
  • staff near unfriendly
  • staff near nice
With a word group, however, you can combine all of the attitude words together, and would need to create only one rule:
Word group

Handle: #attitude_en

Words Included in group: friendly, rude, professional, kind, unfriendly, arrogant, temper, lazy, mean, nice

Rule: bellhop near #attitude_en within 5 words

Restriction: Word groups apply only to standard topics.

Create a word group

  1. Open the word group list. To open the word group list, open the Topics screen and click on a topic's name, or select it and click the Edit button at the bottom of the side panel. The Edit Topic screen displays.

  2. Use the Preview dropdown above the side panel to select the Word Groups option. The side panel displays existing word groups. Words are listed in alphabetic order. Highlighting in the list indicates a word using exact-match.

    Word group list in the side panel with option to Add a Word Group

  3. Click Add a Word Group. The Create Word Group dialog opens.

  4. In the Name property, enter a name. This is the name to use when referencing the word group in rules. For example, attitude_en.

    Note: The hashtag prefix shown in the word group list is added automatically.
  5. Enter the words to be included in the group. Separate individual words with a comma and a space. Each word in a word group must be unique to that word group.
    Important: Only individual words can be added to a word group. To add a multi-word phrase to a word group, create a user feature for that phrase first.
  6. Click Add icon Add or press Enter to add the words in the text box to the word group.

    The Create Word Group dialog

  7. Optionally, if enabled for your instance, click Exact match icon Word match for any word in the group, and then select how to match that word to comments.

    For more information, see Word matching for standard topics

  8. Click Save.

    The word group is added to the list of word groups, and can be used in rules. For example:

    A rule with bellhop near #attitude_en

    Note: Be mindful about using Exact match icon Word match when adding word groups to rules. If you select an exact match for a word group, the rule interprets the pound sign as part of the match. For example, if you create a rule with an exact match for the #attitude_en word group, Text Analytics tags comments for the rule only when they include #attitude_en, without considering the words in that group.

Edit word groups

Warning: Editing existing word groups affects all rules that use the word group for all topic sets. Editing a word group used for active Text Analytics processing can automatically affect existing rules for incoming surveys. Historical surveys must be reprocessed to use the edited word group.

To edit a word group, use the options icon the word group options menu and select Edit. The Edit Word Group modal displays with the same options described for the Create a word group section above.

Filter word groups

Use the dropdowns above the word group list to filter word groups. There are two dropdowns: one to filter for human- or AI-generated word groups, and one to filter for used and unused word groups. The following image shows both filters with the Type dropdown expanded. Word group list with the word group type dropdown filter expanded

Delete word groups

Important: Remove word groups from topic rules before attempting to delete them. Word groups cannot be deleted unless they are used by 0 topics.

To delete an individual word group, use options icon the word group options menu and select Delete. For example, the following image shows the word group options menu for the #adapt_en word group. Word group list with the word group options menu displayed for #adapt_en

To delete multiple word groups, use the check box next to each word group to be deleted. A delete icon Delete button appears above the list of word groups. When you have selected all the word groups to be deleted, use the delete icon Delete button. For example, the following image shows the word group list with several groups selected for deletion. Word group list with three unused word groups selected and the Delete button active

View topics that use a word group

Each word group name in the list is followed by a number in parentheses which indicates the number of standard topics referencing that word group.

The number is a hyperlink, and when selected, it displays a list of topics that reference the word group; each listed topic is followed by a link to each language variant that references the word group. Select these links to view each referencing topic.

For example, the following image shows the word group list with topic numbers after each word group name, with the list of topics for #accuracy_en displayed. Word group list with pop-up display of 10 topics that use the accuracy_en group