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

# Insights

> What your evidence adds up to, scored so you can tell a real pattern from a loud one.

An insight is Squad's conclusion about a group of evidence. It reads "export is unusable above 10k
rows and it is costing you enterprise renewals", rather than "twelve people mentioned export speed".
Every insight carries an `IN-` reference, a score, the signals behind it, and the goals it bears on.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/squad/NVM9RUFBB2kdWosT/images/insights-light.png?fit=max&auto=format&n=NVM9RUFBB2kdWosT&q=85&s=dbd7013e8728a92ac4a58b9e1beb7eb6" alt="Insights" width="2880" height="1800" data-path="images/insights-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/squad/NVM9RUFBB2kdWosT/images/insights-dark.png?fit=max&auto=format&n=NVM9RUFBB2kdWosT&q=85&s=81bfe3f16877a0bc53e4228fcdc0192e" alt="Insights" width="2880" height="1800" data-path="images/insights-dark.png" />
</Frame>

For how insights get created, see [The evidence pipeline](/pipeline).

## The list hides positive insights by default

The **Hide positive** toggle at the top of the Insights list is on when you first arrive. It filters
out everything categorised as a positive signal, so the list is shorter than the number of insights
the workspace actually holds. Turn the toggle off to see them.

You're usually here to find what's broken. When the filter leaves the list looking empty, the empty
state says "Positive insights are hidden."

## The Insights list

Sorted by score, highest first. Each row shows the `IN-` reference and title, the score bar, the
number of linked goals, the number of supporting signals, and the creation date.

Hover the score bar to see the split between **Strength** and **Momentum**.

Search with **Search insights or IN-…**. Filter by **Score**, **Goals**, or **Data Signals**, each
with presets and a "greater than or equal to" default. Sort and filter state lives in the URL.
Right-click a row for **Open**, **Copy ID**, **Copy URL**, **Copy content as JSON**, and **Delete**.

**Import Insights** in the top right brings in insights you already hold elsewhere. You can also
drag files onto the page to have Squad read them.

## How the score works

The score is a number between 0 and 1 with two components.

<AccordionGroup>
  <Accordion title="Strength: how well evidenced is this?" icon="shield-check">
    It combines the volume of supporting signals, statistical confidence in that volume, how many
    distinct customers those signals came from, and how many different kinds of source corroborate
    it. Evidence concentrated in one loud customer scores lower than the same volume spread across
    many. A young insight is pulled toward the workspace baseline rather than crushed to zero.
  </Accordion>

  <Accordion title="Momentum: is this alive?" icon="trending-up">
    Recent signals count for more than old ones, a burst of arrivals lifts it, and the last four
    weeks of arrivals are read as accelerating, steady, or decelerating.
  </Accordion>
</AccordionGroup>

The combined number weights strength at 60% and momentum at 40%.

<Note>
  Scores move when new evidence reaches the insight. They don't decay on their own, so an insight that
  stopped receiving signals keeps its last score. Read the score alongside the date and the signal
  count.
</Note>

## Category and status

**Category** is yours to change from the detail page. The options are Pain Point, Feature Request,
Positive Signal, Trend, and Risk. Recategorising an insight as Positive Signal hides it from the
default list view.

**Status** is read-only, a freshness indicator Squad manages. Four values.

* <Icon icon="circle-dot" /> **Active**
* <Icon icon="clock" /> **Stale**
* <Icon icon="archive" /> **Archived**
* <Icon icon="circle-check" /> **Resolved**

An insight goes stale when nothing new arrives for a while. The window depends on how fast your
workspace normally moves.

## Inside an insight

The page opens with the title and description.

<Icon icon="radio" /> **Representative data signals.** Up to three quote cards showing the actual
customer words behind the conclusion. **View all** opens the full table when there are more.

<Icon icon="square-check" /> **Squad recommends.** The purple panel on the right holding the ranked
actions for this insight. If there are none yet, you can ask Squad to propose some from here. See
[Actions](/actions).

<Icon icon="info" /> **Info.** Category, status, the score breakdown, and counts of linked goals and
supporting signals.

<Icon icon="trophy" /> **Goals.** The goals this insight bears on, with **Link goals** (or **Manage
links** once there are some) to change them. See [Relationships](/relationships).

<Icon icon="link" /> **Referenced by.** Any brief or knowledge document whose body cites this
insight.

<Icon icon="activity" /> **History.** Every change to the insight, with a link through to full
workspace activity.

## Reading a score honestly

<Columns cols={2}>
  <Card title="High score, two signals, recent" icon="eye">
    Momentum with thin evidence. Worth watching, not worth a roadmap slot.
  </Card>

  <Card title="High score, 40 signals, four source types" icon="shield-check">
    A case you can take into a planning meeting.
  </Card>
</Columns>

Open the supporting signals before you commit. The score tells you how much evidence there is. Only
the quotes tell you whether it's the evidence you thought it was.

## Cookbook

**Find this quarter's real problems.** Leave **Hide positive** on, sort by score descending, and
filter **Data Signals** to 5 or more. That's your shortlist. Open the top three and read the
supporting quotes.

**Check whether an insight connects to strategy.** Filter **Goals** to 0. Anything scoring well
with no goal attached is either a gap in your goals or an insight nobody has connected yet. Link it
from the insight's **Goals** panel.

**Turn an insight into work.** Open a high-scoring insight, read **Squad recommends**, pick the
action that matters, and start it. If the action's job is a written artefact, generate a
[brief](/briefs) from it.


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