Topics screen

The Topics screen in Medallia Admin Suite enables you to build and manage the topics that extract meaningful insights from customer comments

To access the Topics screen, select the Text Analytics > Topic Builder tile option in Medallia Admin Suite, or select the Text Analytics > Topics option on the sidebar.

Your instance has one or more topic sets provided during the initial configuration of your Text Analytics implementation. Select a topic set on the Topics screen to see the topics and rules defined for that topic set.

For example, the following image shows the Appointments parent topic selected with the Automotive topic set.

The Topics screen with the Topic Set option highlighted

Note: The Topic Hierarchy tab, generative AI icon Topic Discovery tab, and generative AI iconDiscover Topics with AI button shown in these screen captures display only when Smart Topic Builder is enabled for the instance and the user's role.

Keyboard navigation

The Topics screen and other screens support keyboard navigation for accessibility and ease of use. Using a keyboard instead of a mouse or touchpad to navigate and interact with user interface elements can be especially time-saving when creating topics.

When using keyboard navigation, selected elements are outlined or highlighted in blue or white.

  • Use Tab to navigate forward one UI element, or Shift + Tab to navigate backward.

  • Use the arrow keys to interact with dropdown menus and lists, and to scroll the current viewport.

  • Use Return, Enter, or the spacebar to select an element, expand a list, check a checkbox, open a dropdown, or enable a toggle.

  • Use Return or Enter to confirm your entry to a text input field, or Escape to cancel.

Topic settings

The Topics screen includes settings used to create and manage topics. Select More icon > Settings icon Settings on the Topics screen to open the Topic Settings dialog. The first two settings apply to your entire instance, and to all administrators working with topics. The notification setting applies only to you.

Note: The notification toggles shown are inherited from the email and push notification settings configured in Reporting.

The Topic Settings dialog

Note: Enablement of the historical data setting feature is still in progress and may not be available for all instances. Contact your Medallia representative for more information.

The historical data setting enables you to set when historical data begins appearing in reports after you activate or publish changes to topics. Because newer data is processed before older data, you might want that newer data to appear in reports before all of the historical processing has completed. Select from the following options:

  • All the selected historical data is processed — No historical data appears in reports until all historical data has been processed.

  • An amount of historical data is processed — Selecting this option causes another dropdown to appear, enabling you to select the minimum amount of historical data processing that must be completed before data begins appearing in reports.

  • Immediately without historical data — New topics and published changes to existing topics are available in reports immediately after activation or publication, and historical data appears as it is processed.

The data type setting enables you to select whether your instance collects only non-conversational data (such as with surveys), only conversational data, or both types of data. Conversational data is that which has been imported to an Experience Cloud field that supports personas. For Medallia Speech, this is the Medallia Speech transcript field (q_speech_comment). For other products that support conversations (such as Medallia Conversations), this is the Conversational transcript comment field (q_conversational_transcript_comment). When using only non-conversational data, you cannot select specific speakers (Agent or Customer) in compound topic rules.

Important: This feature is available upon request. Ask your Medallia expert to file a Feature activation request with Medallia Support.

Enable email and push notifications (for mobile devices) if you want to be notified by those methods when historical-data processing completes or fails. Regardless of these settings, you always receive a notification in the Medallia Web reporting notification center.

Topic set description

Each topic set can have a topic set description, which defines the topic set's purpose, dataset, audience, and exclusions. A topic set description must be present to run topic discovery with Smart Topic Builder.

View or add a topic set description from the Topic Hierarchy tab on the Topics screen. Topic set descriptions include these components:
What are you using the topic set for?
Required. Minimum 10 characters. Describes the overall goals or purpose for the topic set.
Audience
Required. Minimum 5 characters. Describes the audience that uses the analysis produced by Text Analytics processing.
Dataset type
Optional. General information about the data that topics in the set will analyze.
Should not capture
Optional. Concepts that should be excluded from the topic set.

Once a topic set description has been defined or updated, it is available to be viewed on the Topics screen, and it is used to generate future output from topic discovery with Smart Topic Builder. Previously generated discovery results are not affected.

Each topic set can have one topic set description; topic sets do not have distinct descriptions for languages or segments. Topic set descriptions are not included in topic XML or CSV export data, nor can they be imported with topic XML.

Edit topics with the details pane

Expand any parent topic in the list to see its child topics. If you want to change the name of a topic, hover over the topic, and click Edit icon to edit. Click the name of a child topic to open a page containing the rules defined for that topic.

Select Checkmark icon the box next to any topic to expose more options for managing the topic. Selecting the box next to a parent topic also selects all of its child topics. For example, in the following image, the Fitting Rooms parent topic and all of its child topics are selected.

The Fitting Rooms parent topic and its child topics selected

The details pane on the right shows by default for any selected topic. The details pane shows information such as the topic status, rule type, where the topic is used, the date the topic was last modified, when it was last published, and when it last had historical data processing started. Toggle Show Comments from ON or OFF to disable or enable the details pane.

Summary Panel with Show Comments OFF

Note: The date for last historical processing applies only to historical processing initiated in Admin Suite. Historical processing initiated in Medallia Setup is not reflected here.

Use the Rules dropdown to filter by topics that contain or do not contain rules in the Language and Segment settings set by their respective dropdowns. The default for both Language and Segment is All.

Manage topics and perform bulk actions with the topic menu

After you select topics, you can perform bulk actions on them. If you have selected multiple topics, only the buttons applicable to all selected topics appear. The More vertical icon. topic menu in each row provides the same options for the topic in that row:

Activate
Activates selected new or inactive topics, making them available for text processing and reports. Activating a child topic also activates its parent topic.
Deactivate
Click to deactivate (but not delete) topics, making them unavailable for new text processing, and preventing them from being available in reports. If a parent topic has only one child topic, deactivating the child topic also deactivates the parent topic. You cannot deactivate topics used by other topics.
Publish changes
Publishes updates to selected active topics, making those changes available for text processing and reports.
Update historical data
Reprocesses historical data for selected active topics. For more information, see Process historical data.
Visibility
Determines which roles have permission to see the selected topics in reports.
Export
Produces an XML or CSV version of the selected topics. XML files contain topics and rules, while CSV files contain only the topic hierarchy. Selected synonyms and negation settings are also exported in XML. You can copy an export, and manually save it as a text file for import into another system. Medallia Experience Cloud does not store backups of topics. Export your topics regularly to maintain backups.
Duplicate
Creates duplicate topics. If you duplicate a parent topic, its child topics are also copied.
Delete
Deletes the selected topics. This action cannot be undone.
Restriction: You cannot deactivate or delete topics that are used in Formula fields.

The Status column indicates the status of each topic. Possible states include:

  • Draft — The topic is new, and has not yet been activated. Topics in the draft state are not available for text process, and are not visible in reports. Draft topics are available to be used in topic rules.

  • Active — The topic has been published. The topic is available for text processing, and is visible in reports.

  • Inactive — The topic is not available for text processing, and is not visible in reports. Inactive topics cannot be used in compound topics. Historical data for the topic is retained.

When an active topic has been edited, the topic is marked with an orange circle to indicate the topic has unpublished changes. For example:

An active topic with unpublished changes

The Topics screen includes a way to view which language and segment intersection for each topic has rules assigned. Use the dropdowns to select the Language, Segment, Rule Type, Status, and Rules. Then, select the topic for which you would like to view the rules applied. These details then appear in the summary panel.
Note: Toggle the Show Comments OFF to Show Comments ON to switch between the summary panel and the comments panel.
Topics screen with Used In section showing

The Used In section indicates how many places each topic is used by other Medallia Experience Cloud entities, including topics, alerts, report modules, etc. Click the text in the Used In column to open a pop-up showing the specific entities using the topic. For example, the following image shows that a subtopic in the Purchasing Experience parent topic is used in two reporting modules. In the dialog, click an entity to open that entity for editing. Used In link on Topics screen Used In details on Topics screen

Review comment text with the Comments panel

Toggle Show Comments OFF to Show Comments ON to display comments in the summary panel area. Sort the list of comments by captured comments, uncaptured comments, or a combination of captured and uncaptured comments (All).

Comments panel in the main list of topics

You can view the captured comments in the Comments panel. The comments count reflects the number of records containing the comments captured by published rules. The comments captured are across all segments for the selected language. The number of comments will be the same for all segments, but may change when switching languages. When the comment side panel is open, comments are shown for all languages and all segments. Selecting new options from the drop-downs will also change which comments are shown.