> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# Customer Insights settings

> Manage insight categories, review the ones the AI suggests, and write instructions that steer what counts as an insight. Use it when tuning Customer Insights.

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.

> [!NOTE]
>
> Open [Customer Insights](https://platform.open.cx/reports/voice-of-customer) 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:

| Type | Where it comes from | What you can do |
| - | - | - |
| System | Built in: **Feedback**, **Bug**, **Feature Request**, **Knowledge Gap**, **Other** | Use them. They cannot be edited or deleted |
| Custom | Created by you, or a suggestion you approved | Edit or delete |
| Suggested | Proposed by the AI when no category fits | Approve or reject |

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](https://docs.open.cx/api-reference/customer-insights/approve-category.md) and [reject](https://docs.open.cx/api-reference/customer-insights/reject-category.md) 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](https://docs.open.cx/reports/customer-insights.md#how-insights-are-created).

> [!NOTE]
>
> 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](https://docs.open.cx/reports/customer-insights.md#work-on-an-insight). Very similar insights in the same category are combined automatically.

## Troubleshooting

| Symptom | Likely cause | Fix |
| - | - | - |
| No **Settings** button | You lack **Voice of Customer: Write** | Ask an admin to add it in [Settings → Roles](https://platform.open.cx/settings/roles) |
| No new suggested categories | Suggestions are off, or you reached 150 categories | Turn on **Automatic category suggestions**, or delete or reject categories you no longer need |
| **Reject Category** or **Delete Category** stays disabled | No fallback category chosen | Pick a category under **Move insights to** |
| **Save Instructions** does not save an empty field | The field cannot be saved empty | Keep at least one instruction, or clear it with the [update settings](https://docs.open.cx/api-reference/customer-insights/update-voc-settings.md) API endpoint |

***

## Related Documentation

> [card] [Customer Insights report](https://docs.open.cx/reports/customer-insights.md)
>
> Work with insights

> [card] [Reports overview](https://docs.open.cx/reports/overview.md)
>
> Reports & Apps and pinning

> [card] [Roles](https://docs.open.cx/security/roles.md)
>
> Voice of Customer permissions

> [card] [Customer Insights API](https://docs.open.cx/api-reference/customer-insights/index.md)
>
> Categories and settings API


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.