Skip to main content
Customer Insights settings control how insights are sorted into categories and what the AI looks for when it reads sessions. Use them to keep categories tidy and to focus insights on what matters to your business.
Open Customer Insights and select Settings. The Voice of Customer Settings dialog has two tabs: Categories and AI Instructions. Requires Voice of Customer: Write; without it, the Settings button is hidden.
Changes apply to sessions analyzed from then on. Existing insights keep their content; they change category only when you delete, reject or approve a category they are in.

How categories work

Every insight belongs to one category. The AI picks a category for each new insight from your list, using each category’s name and description. The Categories tab lists them with a type: An organization can have up to 150 categories across all three types. The usage bar shows how many of each you have. At the limit, the AI still files insights under your existing categories but stops suggesting new ones; insights that fit nothing go to Other. You can still create and approve categories yourself. Use the search box and the type filter (All types, System, Suggested, Custom) to find a category.

Turn AI category suggestions on or off

Under AI category suggestions, Automatic category suggestions is on by default. When no existing category fits with enough confidence, the AI creates a Suggested category and files the insight under it right away, so it shows in the list while the suggestion waits for review. With suggestions off, insights that fit nothing go to Other. Custom suggestion instructions (optional) guide how the AI names suggested categories, how broad they are and how it categorizes. For example: “Prefer broad categories over specific ones. Use business-oriented language.” The field is disabled while suggestions are off. Select Save changes.

Review suggested categories

  1. Set the type filter to Suggested.
  2. Open the actions menu (⋮) on a category.
  3. Select Approve or Reject.
Approve turns the suggestion into a Custom category. If a Custom category with the same name already exists, its insights move there and the suggestion is removed. Reject asks where its insights go. Choose a category under Move insights to, optionally add a Reason, and select Reject Category. The suggestion leaves the list. If the AI suggests the same name again later, it comes back for review. The dashboard reviews one suggestion at a time. To approve or reject up to 100 at once, use the approve and reject API endpoints.

Create, edit or delete a category

1

Add a category

Select Add category, enter a Name (up to 60 characters) and an optional Description (up to 200 characters), then select Add category in the dialog. Names must be unique, ignoring case. Adding a name that matches a pending suggestion approves that suggestion instead.
2

Edit a category

On a Custom category, open ⋮, select Edit, change the name or description and select Update Category. The AI reads both when it picks a category.
3

Delete a category

On a Custom category, open ⋮, select Delete, choose where its insights go under Move insights to, and select Delete Category.

Write AI instructions

On the AI Instructions tab, Custom Analysis Instructions adds your own rules to every future analysis, up to 1,000 characters. Select Save Instructions. Insights that already exist do not change. Use them to focus detection on your product, for example:
  • “We sell a mobile banking app. Treat problems with card activation and transfers between own accounts as product issues.”
  • “Ignore feedback about third-party delivery partners; we do not control them.”
The instructions add to the built-in rules described in what counts as an insight.
The dialog has no alert or occurrence-threshold setting. Returning issues show up when a resolved insight reopens or an archived one comes back; see Customer Insights. Very similar insights in the same category are combined automatically.

Troubleshooting


Customer Insights report

Work with insights

Reports overview

Reports & Apps and pinning

Roles

Voice of Customer permissions

Customer Insights API

Categories and settings API