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

# Insights Radar

> Surface AI-generated findings automatically inside your reports and review them all in one project-level list.

**Insights Radar** are findings that Caplena generates automatically from your report views and surfaces in a side rail next to your report. Use them to spot shifts, drivers, and noteworthy patterns without having to ask Agent each time you open a report. You can also add your own insights manually to capture observations alongside the AI-generated ones.

[Loom video player](https://www.loom.com/embed/69e8cdfd6291401791c8c516283227e0)

> [!TIP]
>
> Insights Radar and [Tasks](https://docs.caplena.com/insight-and-reports/insights-and-tasks/tasks.md) are closely connected: an insight surfaces a finding, and a task turns it into assigned, trackable follow-up work. See [How Insights and Tasks work together](https://docs.caplena.com/insight-and-reports/insights-and-tasks/tasks.md#how-insights-and-tasks-work-together) for the full picture.

## Turning on Insights Radar

Insights Radar is enabled per report view.

> [!NOTE]
>
> When you create a report view, Caplena can **turn on Insights Radar for it automatically** with a **Weekly** update frequency, as long as your organization still has room for more views with insights. Views that are off stay off until you turn them on. You can change the update frequency or turn it off for any view using the steps below.

![Clean Shot 2026 09 27 At 21 45 46](https://mintcdn.com/caplena-32172960/r60BD2E2uXfR8jum/images/CleanShot-2026-09-27-at-21.45.46.gif?s=400ed9175ecfce69c249c2ae306c558b)

**1. Open the view settings**

Open your report, click the **pencil icon** in the top-right corner, and select **Bulk edit view settings**.

**2. Choose an update frequency**

In the **Insights updates** column, open the dropdown next to the view you want and choose an option. See [Update frequency options](#update-frequency-options) for what each option does.

**3. Save**

Click **Done**. With a scheduled frequency, Caplena generates insights automatically for the view from then on.

### Update frequency options

| Option | Insights shown | Regeneration |
| - | - | - |
| **Off** | No. Insights are hidden everywhere for the view. | None. |
| **Manual** | Yes. | Only on demand. Caplena doesn't regenerate insights or look for new ones on a schedule. |
| **Daily**, **Weekly**, **Bi-weekly**, **Monthly** | Yes. | Automatically at the chosen interval. |

* Use **Manual** when you want to keep a view's insights visible without spending runs on scheduled updates.
* Use **Off** when you don't want insights for a view at all. The report side rail is hidden, and the view's insights are also hidden from public links, MCP, and Agent.

Switching a view from **Off** to **Manual** triggers a first generation of insights for that view. This first generation counts as one run.

> [!NOTE]
>
> Demo projects default to **Manual**, so they don't use runs on scheduled updates.

The **Insights updates** column header shows your organization's run budget (for example, **60 of 60**). See [Limits](#limits) for how runs are counted.

> [!NOTE]
>
> Only standard insight elements generate insights. [Custom Insight Elements](https://docs.caplena.com/insight-and-reports/insight-elements/custom-insight-elements.md) don't.

## Where you see Insights Radar

* **Report side rail** — a collapsible panel on the right of any report view, shown as collapsed badges or expanded card stacks. The rail header shows the total insight count and the date of the most recent activity.

![Screenshot 2026 08 19 At 10 27 30](https://mintcdn.com/caplena-32172960/uQ0V0CHQ_Dwz6zIA/images/Screenshot-2026-08-19-at-10.27.30.png?fit=max\&auto=format\&n=uQ0V0CHQ_Dwz6zIA\&q=85\&s=b21e9447441c68e7ad6478190579450f)

* **Per insight element** — each insight element can have multiple insights, accessible via the chip on its upper-right side. When an element has related Insights Radar entries, a small sparkles button appears; hover or click it to see those insights in a popover, then open one to expand the rail directly to that card.

![Screenshot 2026 08 19 At 10 28 57](https://mintcdn.com/caplena-32172960/uQ0V0CHQ_Dwz6zIA/images/Screenshot-2026-08-19-at-10.28.57.png?fit=max\&auto=format\&n=uQ0V0CHQ_Dwz6zIA\&q=85\&s=14d0ff0792288fe740ec065af51f3847)

* **Insights board** — a dedicated project-level page where you can browse every insight across all report views, grouped by view or by project.

![Screenshot 2026 08 19 At 10 30 50](https://mintcdn.com/caplena-32172960/uQ0V0CHQ_Dwz6zIA/images/Screenshot-2026-08-19-at-10.30.50.png?fit=max\&auto=format\&n=uQ0V0CHQ_Dwz6zIA\&q=85\&s=016213497abd1b8be09fc00ac98cf439)

> [!NOTE]
>
> Insights Radar is scoped to a saved report view. If you change filters or segments away from the view's saved configuration, the rail is disabled until you reset back to the saved view.

Anyone who can see a report view can also see its insights and linked tasks.

## The Insight lifecycle

Every insight goes through three stages:

1. **Discovery** — on a regular interval (for example, weekly), Agent looks for interesting findings across your reports. If it finds something worth showing, an insight is created and shown in the report. If it doesn't find anything noteworthy, nothing is shown.
2. **Updates** — on the same regular interval, live insights are rechecked and refreshed with the latest data, so the numbers stay current for as long as they remain relevant.
3. **Retirement** — once an insight is no longer relevant, it's retired and removed from the view. A new insight can spawn later if the underlying data starts shifting again.

For example, in an NPS report: for as long as the score stays relatively constant, no insight is shown. If the NPS moves, an insight is created highlighting the change and its likely drivers. It keeps refreshing on the regular schedule as long as the shift remains meaningful. Once the score stabilizes, the insight is retired.

You can also dismiss an insight yourself at any time, regardless of where it is in its lifecycle. If a task is linked to an insight and **auto-close** is enabled on that task, the task closes automatically when the insight is dismissed or retired — see [Auto-close](https://docs.caplena.com/insight-and-reports/insights-and-tasks/tasks.md#the-task-detail-page).

## Reading an insight card

Each Insights Radar card includes:

![Screenshot 2026 08 19 At 10 34 53](https://mintcdn.com/caplena-32172960/uQ0V0CHQ_Dwz6zIA/images/Screenshot-2026-08-19-at-10.34.53.png?fit=max\&auto=format\&n=uQ0V0CHQ_Dwz6zIA\&q=85\&s=799fbc6c1270fc05042de8248253d013)

* **Title** — short summary of what was found.
* **Sentiment** — a smiley showing whether the finding is positive, neutral, or negative.
* **Body** — markdown-formatted explanation, often with supporting numbers or topic references.
* **Chips** — metadata tags such as the source insight element, the public ID, whether the insight is outdated, and whether it was created by a user or by Caplena.
* **Actions menu** (burger icon, top-right of the card) — ask Agent a follow-up question about this insight, open the insight's detail page, [create a task from it](https://docs.caplena.com/insight-and-reports/insights-and-tasks/tasks.md#creating-a-task-from-an-insight), archive it, or dismiss it.

Dismissed insights are hidden from the rail and the count, but remain available in the project-level list if you filter for them.

## Notifications

You get a notification in your Caplena inbox when a new insight or task is created, and whenever an existing insight or task changes. You can also have these notifications delivered by email, Slack, or Microsoft Teams.

### Configuring notification settings

Go to **Settings → Notifications** to choose which insight and task events reach you outside the Caplena inbox, how often, and on which channels. Notifications always appear in your Caplena inbox, whatever you set here.

The settings are shown as a table with three groups. Click a group to expand it and see its notification types:

| Group | Notification types |
| - | - |
| Insights | New, updated, outdated, archived |
| Tasks | Task assigned, due soon, closed |
| Billing | Generation skipped because the run budget was reached |

For each notification type, you set each channel separately:

* **Email**: Choose a frequency from the email pill. Select **Instant**, **Daily**, or **Weekly** to receive emails at that cadence. Select **Inbox only** to turn off email for that type. Select **Default** to use Caplena's default for that type (the **Balanced** value).
* **Slack** and **Teams**: Select the checkbox to turn the channel on. Slack and Teams notifications are always delivered instantly, so these columns have no frequency setting.

For example, you can receive new insights in a weekly email digest while also getting each one in Slack as it happens.

The group row sets the email frequency and the Slack and Teams checkboxes for every type in the group at once. A dashed **Mixed** pill or a partially filled checkbox means the types in that group have different settings.

> [!NOTE]
>
> Slack and Teams must be connected before you can select them. If a channel isn't connected, click **Connect** next to its column header to open the integration setup.

#### Presets

Use the presets above the table to fill in the whole table at once:

| Preset | What it does |
| - | - |
| **Quiet** | Turns off all external notifications. You still see them in your Caplena inbox. |
| **Balanced** | Sends key events without flooding you. See the table below. |
| **Everything** | Sends every notification type instantly by email, Slack, and Teams. |
| **Custom** | Selected automatically when you change individual settings so they no longer match a preset. You can't select it directly. |

The **Balanced** preset uses these settings:

| Notification type | Email | Slack and Teams |
| - | - | - |
| New insights | Weekly | On (instant) |
| Archived insights | Weekly | On (instant) |
| Updated insights | Off | Off |
| Outdated insights | Off | Off |
| Task assigned, due soon, closed | Instant | On (instant) |
| Generation skipped (budget reached) | Instant | On (instant) |

Slack and Teams notifications are only sent when you've connected the integration.

> [!NOTE]
>
> If you've never changed your notification settings, Caplena uses the **Balanced** values as your defaults.

Start with a preset, then adjust individual rows. Caplena saves each change immediately.

## Adding a manual insight

Insights aren't only created automatically — you can add your own:

![Clean Shot 2026 08 19 At 10 59 56](https://mintcdn.com/caplena-32172960/uQ0V0CHQ_Dwz6zIA/images/CleanShot-2026-08-19-at-10.59.56.gif?s=682bf916cb30b01205117413141d87f5)

1. Open the report and go into **Configure View** mode.
2. Click **Add Insight**.
3. Choose **Manual**, give it a title and a description.
4. Save it.

Your insight appears in the rail alongside AI-generated ones, marked as user-created so it's clear who authored it.

> [!TIP]
>
> Manual insights are useful for pinning analyst commentary, decisions made in review meetings, or context that the AI doesn't have access to (for example, a known data quality caveat).

## Archiving an insight

You can archive an insight in two ways:

* **From the report**: In **Configure View** mode, open the burger menu on an insight and select **Archive**.

![Clean Shot 2026 10 23 At 09 14 29](https://mintcdn.com/caplena-32172960/l78MHXqExExrMSFF/images/CleanShot-2026-10-23-at-09.14.29.gif?s=03720e66843ef07cb7fd1ea3e6fa1af2)

* **From the insight detail page**: Click the **Archive** button (box icon) next to the insight's other actions.

![Clean Shot 2026 10 23 At 09 36 07](https://mintcdn.com/caplena-32172960/l78MHXqExExrMSFF/images/CleanShot-2026-10-23-at-09.36.07.gif?s=e7fd9c4d2f165aa395032361840154f2)

Archiving stops updates and archives the insight and similar ones for all users of the report view. Archived insights are removed from the active rail but aren't deleted.

To restore an archived insight, go to the Insights board, filter by **Archive status**, and click **Unarchive**. **Unarchive** is only available for insights that a user archived. Insights that Caplena archived automatically can't be restored.

![Clean Shot 2026 10 23 At 09 43 34](https://mintcdn.com/caplena-32172960/l78MHXqExExrMSFF/images/CleanShot-2026-10-23-at-09.43.34.gif?s=0288de1872565b0d9fcea69b52c7a346)

## Disabled state: filters or segments diverge from the view

Insights Radar is tied to the saved configuration of a report view. When you change the report's filters or segments so that they no longer match the saved view, the rail is disabled and the button shows a popover explaining why. Click **Reset** in the popover to restore the view's saved filters and segments and re-enable the rail.

## Limits

During the **introductory period**, which runs until **31 December 2026**, the Enterprise, Team, and Agency plans include **60 insight runs per organization**. A run checks a view for new insights and updates existing ones, which can also retire insights that are no longer relevant.

You decide how to spread the 60 runs across your views. For example, you can update one view frequently or several views less often. More views and higher frequencies use up runs faster.

> [!NOTE]
>
> A run is only counted when something has changed. If the underlying data, the report, and the view all stay the same (no new rows, no added insight elements, no changed filters), no run is deducted.

> [!NOTE]
>
> **No cost during the introductory period.** Insights Radar is free to use until 31 December 2026. Nothing will be billed automatically when the introductory period ends.

## Related

* [Tasks](https://docs.caplena.com/insight-and-reports/insights-and-tasks/tasks.md) — turn an insight into assigned, trackable follow-up work.


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