---
title: "Search your documents"
description: "Query datasets, scope by dataset, and work the results list."
canonical: https://ocho.bot/docs/search/search-documents
last_updated: 2026-07-12
---

# Search your documents

> Query datasets, scope by dataset, and work the results list.

## Run a search

1. Open the Search page. The resting view is the dataset map — a full-screen    graph of your datasets. 2. Scope the search with the dataset dropdown to the right of the search box.    It reads **All datasets** (the default) or **N of M datasets**. Clicking it    opens a list with a checkbox per dataset, each showing its document count.    Type in the **Filter datasets…** box to narrow a long list by name, and use    **Select all** to restore everything. At least one dataset must stay    selected — the last checked row can't be unchecked. 3. Type your query. The search runs automatically a moment after you stop    typing (no submit button).

Running a search drills the graph into the top hit's dataset and shows the results next to it. While drilled in, the dataset dropdown is hidden — click **Back to map** to change your dataset selection (clearing the query closes the results but keeps you drilled in). Reloading doesn't help: the search re-runs and drills right back in.

## Typeahead

From two characters on, a dropdown suggests:

- **Entities** — people, materials, concepts extracted into the graph, with

their type and how often they're mentioned (for example   "PROCESS · 6 MENTIONS"). Clicking one opens its top passage in the source   viewer, with **Graph neighbors** and **Search results** tabs alongside. For   PDF sources the passage is highlighted in the full document; other formats   (like markdown) show the full document, sometimes with a one-line gist   banner when a summary is available.

- **Documents** — matched by exact filename text; selecting one opens the

document in a new tab. Note the match is literal, so "100m offers" won't   find "100m_offers.pdf".

Suggestions are selected by clicking only — pressing Enter does nothing, even with the dropdown open. The search itself runs automatically anyway.

## Read the results

Each result row shows a color-coded relevance percentage, the source file and page (like "100m_offers.pdf · p80"), and a snippet. Hovering a row highlights that document's node in the graph. Two actions per row:

- **Open source** — view the passage in the full document. PDF sources show

it highlighted; other formats open without a highlight (a one-line gist   banner appears when a summary is available).

- **Chat about this** — a "Chat about this source" dialog asks whether to

start a **New chat** with the excerpt as the prompt or add it to an   **Existing chat** (your last 10 conversations). The chat composer arrives   prefilled with the quoted passage, ready for your question.

## Adjust the layout

On desktop, three preset buttons set the graph-to-results split (30/70, 50/50, 70/30). Your choice is remembered across sessions and devices.

## Good to know

- Some datasets show a small "no graph" tag in the dataset dropdown. They

stay fully selectable and searchable, and their graph can still render when   a search drills into them — the tag only stops you from clicking their cell   on the dataset map to drill in manually.

- Results are capped at the 20 best passages — refine the query rather than

paging.

- Search always returns the closest passages it can find, so a query that's

off target shows up as low relevance percentages rather than an empty list.   If everything scores low, check that the right datasets are selected before   rewording the query.

All docs: https://ocho.bot/docs

---

Ocho — AI knowledge orchestration · [Home](https://ocho.bot/) · [Docs](https://ocho.bot/docs) · [Blog](https://ocho.bot/blog) · [About](https://ocho.bot/about) · [Developers](https://ocho.bot/developers) · [Contact](https://ocho.bot/contact) · [llms.txt](https://ocho.bot/llms.txt)