> For the complete documentation index, see [llms.txt](https://evidano.gitbook.io/ailyze-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://evidano.gitbook.io/ailyze-docs/analyze-data/how-to-read-your-results.md).

# How to Read Your Results

A plain-language map of your Evidano results page, so you know what everything means and what to click next.

This page explains the document and spreadsheet results pages for anyone opening a finished analysis: what the [themes](/ailyze-docs/reference/glossary.md#theme), [codebooks](/ailyze-docs/reference/glossary.md#codebook), charts, and quotes mean, which button does what, and where to look first. Every control is listed in [Document Analysis Settings](/ailyze-docs/reference/settings/document-analysis.md#screen-8-the-results-page) and [Spreadsheet Analysis Settings](/ailyze-docs/reference/settings/spreadsheet-analysis.md).

## The vocabulary

| Term      | What it means in Evidano                                                                       |
| --------- | ---------------------------------------------------------------------------------------------- |
| Theme     | A top-level pattern in your data, for example "Clinic timing that does not fit daily life".    |
| Sub-theme | A more specific idea within a theme.                                                           |
| Code      | The most specific label, attached to quotes. With two levels, codes sit directly under themes. |
| Codebook  | The full set of themes, sub-themes, and codes, each with a description.                        |
| Coding    | Tagging each excerpt or row with the codes it expresses.                                       |
| Quote     | A verbatim excerpt that illustrates a code, linked to its file.                                |
| Segment   | A group you compare across, such as district or respondent group.                              |
| Frequency | How many documents or participants (or units, such as outcomes) a theme or code appears in.    |

## The document results page

{% embed url="<https://1178311500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi4GBXPMUDxszIpUVOARU%2Fuploads%2Fgit-blob-a6d065cafb198ebcfde2f61353d74ef2931983a7%2Fanalyze-how-to-read-your-results-04-results-tour.mp4?alt=media>" %}
Video tour of a finished analysis (no sound)
{% endembed %}

{% file src="/files/npgq6DG2eZbxEm6SPLdL" %}
Download this video
{% endfile %}

From top to bottom, with the **Contents** rail on the left:

1. Header: **Back to projects**, the name, chips for the documents and the completion date, and **View changes**.
2. The action row: **Export**, **Ask AI**, **Share**, and **Edit project**.
3. **Executive Summary**, open on its outline; **Show full summary** shows the rest. After a theme edit, a closable note says it may be out of date.
4. The table of all rows, for example **All documents**: a row per document, participant, or unit, and a column per theme, question, or table column. Hover a document's label for its file name.
5. **Codebook**: themes and codes with counts and charts. Its header holds **Edit**, the downloads, and a ⋯ menu with **Calculate AI accuracy** and **Edit groups to compare** (Pro).
6. **Themes** and **Questions**: one block each, with **Summary across all files**, **Codes**, **Comparison across segments**, and **Summary of individual files**.
7. **Summary of each document**, then **Word Frequency Visualization** and **Groups to compare**.

Each document's cell opens on its summary and first quote; **Show quotes (N)** lists the rest, and **Expand all cells** in the rail opens every cell. Documents that do not discuss a theme are listed in one line, "Not discussed in N documents: …". Mid-run, a section not reached yet says "Still analysing" with **Check again**.

<figure><img src="https://1178311500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi4GBXPMUDxszIpUVOARU%2Fuploads%2Fgit-blob-e7788e433f8a1c4eff1a1dbb8814775852b10813%2Fsettings-document-analysis-32-results-header.png?alt=media" alt="Results header with Back to projects, the project name, chips for documents and dates, View changes and Project details"><figcaption><p>The badges follow the header from Back to projects (1) to the project details (6).</p></figcaption></figure>

### Making sense of the charts

* Frequency bar or pie: which codes dominate. **Display** switches between **Raw** and **Percentage**; with a **Segment** chosen, **Put segments on y-axis** sets the groups side by side.
* [Hierarchy graph](/ailyze-docs/reference/glossary.md#hierarchy-graph): how sub-themes and codes nest under themes.
* [Co-occurrence network](/ailyze-docs/reference/glossary.md#co-occurrence-network): which codes tend to appear together, for example cost and trust.
* Word cloud: a quick gist of frequent terms, not a substitute for themes.

## Spreadsheet results — two pages

### The survey dashboard

A per-column summary of the whole survey, grouped into **Text / Numerical / Categorical / Segment / Respondent ID**. Each column has:

* **Visualization** — a chart with a **Segment** selector and **Download CSV/PNG**.
* **Analysis** — an AI narrative, with **View More Analysis** to open that column's per-column results page.

<figure><img src="https://1178311500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi4GBXPMUDxszIpUVOARU%2Fuploads%2Fjhjq2OEAGiFG38vYU56B%2FAnalyze%20Survey%206.png?alt=media&amp;token=c7721137-f8f4-46c6-b0ef-61b5c23a3bbd" alt="The survey dashboard showing per-column charts and an AI narrative summary"><figcaption><p>Every column gets its own card: a chart on one side and the AI narrative on the other.</p></figcaption></figure>

### The per-column results page

The deep dive for one open-ended question:

* **Codebook** and **Synthesis**
* **Frequency Bar Chart (Themes)** and **(Sub-themes)**
* **Hierarchy Graph**, **Co-occurrence Network**, **Word Frequency Visualizer**
* **Data Coded with AI Themes & Sub-themes** — a table with tabs: *AI Labels as List*, *AI Labels as Checklist (with code justifications)*, *Theme & Sub-theme Frequencies*
* **Elaboration of Themes & Sub-themes** — per-theme cards with quotes

<figure><img src="https://1178311500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi4GBXPMUDxszIpUVOARU%2Fuploads%2FZi5xP8LONbcbW9plz1hz%2FAnalyze%20Data%202.png?alt=media&amp;token=d8dbc8fd-3201-4505-b84d-ace5a162a64a" alt="A per-column results page with theme and sub-theme cards and supporting quotes"><figcaption><p>Each theme card shows its sub-themes and the quotes behind them, which is where to verify a finding.</p></figcaption></figure>

## What you can do next

Both results pages have a row of actions:

| Button                                                                              | Purpose                                                                                                                          |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **Ask AI** (documents; the chat button on spreadsheets)                             | Ask questions, build summaries and charts → [Chat with your data](/ailyze-docs/analyze-data/chat-with-your-data.md)              |
| **Export** (documents); **Download as DOCX**, **Download as CSV** (spreadsheets)    | Export the report or data *(Pro)* → [Generate a research report](/ailyze-docs/create-deliverables/generate-a-research-report.md) |
| **Edit project** (documents)                                                        | Add files, themes, or questions, or delete files *(Pro; adding files works on every plan)*                                       |
| **Edit Codebook** (spreadsheets; **Edit** in the **Codebook** header for documents) | Refine themes and codes *(Pro)* → [Build a codebook](/ailyze-docs/analyze-data/build-a-codebook.md)                              |

On documents, **Share** invites colleagues by email or creates a view-only link *(Pro)* → [Export & share findings](/ailyze-docs/create-deliverables/export-and-share-findings.md).

Free accounts see most actions disabled with **Only allowed for paid users**. While analysis is still running, actions are disabled and you'll see **Partial Results** with a banner.

## How to actually interpret it (a quick method)

1. **Start with the Executive Summary and the Codebook** for the big picture.
2. **Sort by frequency** to find what matters most, but don't ignore rare, telling themes.
3. **Open the top few themes**, read the summary, and pull a quote or two from each.
4. **Check segment comparisons** for "who" differences.
5. **Use Chat** to draft your write-up and test it ("Is there evidence against this theme?").
6. **Verify quotes** against the source before publishing.

For new analysis, use **Add Theme** or **Add Question**, not chat.

## Next steps

* [Discover themes and patterns](/ailyze-docs/analyze-data/discover-themes-and-patterns.md) — go deeper into your data.
* [Chat with your data](/ailyze-docs/analyze-data/chat-with-your-data.md) — ask questions and draft your write-up.
* [Analysis issues](/ailyze-docs/troubleshooting/analysis-issues.md) — if your results look off or are missing.