---
title: "Search a project"
description: "Find a word, a phrase or a task key across a project's spec files, tasks and attachments, and open it at the right place."
---

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

# Search a project

> **Pre-Release**
>
> This feature is still rolling out, so it may not be available in your
> organization yet. It can change before general release.

A project's search box finds a word, a phrase or an identifier
such as `AR-CONN-1` or `T012` across everything the project holds, and opens
the result at the right place: the section of a spec file, a task's details,
or an attachment's preview.

## Open the search box

The search box is in the top bar of a project page, next to **Share**.

- Select it, or press **Ctrl+K** (**Cmd+K** on a Mac) from anywhere in the
  project.
- Or press **/** when you are not typing in a text field.

Type at least 2 characters. Results appear as you type, after a short pause.
Before you type, the box shows your **Recent searches** in this project (kept
in your browser only).

## What is searched

| Where | What is searched |
|---|---|
| **Project** | The project's name and description |
| **Spec files** | The text of every spec file, section by section |
| **Tasks** | Each task's key, title, labels, section and description, when the project has a **Tasks** tab |
| **Attachments** | The text inside text files (such as Markdown, plain text, CSV and JSON), Word (`.docx`) and Excel (`.xlsx`) files. Every attachment, PDF files and images included, is also found by its name |

### What is not searched

- Artifacts.
- Comments and discussions.
- Chats and chat sessions.
- Older revisions of a spec file: only the current version is searched.
- Files in the **Trash Bin**. A restored file shows in search again at once.
- The content of PDF files and images (search for their name instead).
- Text past roughly the first megabyte of a very long file.
- Other projects. Search covers one project at a time.

## Write a search

| You type | It finds |
|---|---|
| `rate limit` | Results with both words. In a spec file or an attachment, both words are in the same section |
| `"rate limit"` | The exact phrase |
| `rate -draft` | Results with **rate** but without **draft** |
| `github OR gitlab` | Results with either word |
| `AR-CONN-1` or `T012` | That identifier, matched as one word |

- Upper and lower case never matter, and neither do accents: `resume` finds
  "résumé", and `tim kiem` finds "tìm kiếm".
- Other forms of a word count too: `authenticate` finds "authentication".
- The last word also matches the start of longer words, so results keep up
  while you type.
- A small typo in a single long word is forgiven when few results match it
  exactly. Those results are ranked lower.
- Chinese, Japanese and Korean text is found as you type it, even without
  spaces between words.

## Read the results

Results are grouped under **Spec files**, **Tasks**, **Attachments** and
**Project**, each with its count. A count shows **100+** when there are more.
The best matches come first. A task whose key, or a file whose name, is
exactly your search ranks higher, and on an equally good match requirements
come before other spec files.

Each result shows:

- a short extract with your search words highlighted;
- where it is: the spec file's folder and section heading, the task's key and
  status, or the attachment's name.

Use the arrow keys to move through the results, **Enter** to open one and
**Esc** to close the list.

### Open a result

| Result | Opens |
|---|---|
| A spec file | The file in the viewer, scrolled to the section, with **Find** already filled in with your search |
| A task | The task's details on the **Tasks** tab |
| An attachment | The attachment's preview |
| The project | The project's **Home** |

If a result was moved or deleted after the search, MySpec says
**Could not open this result. It may have moved or been deleted.** Search
again to see where it is now.

## See all results and filter them

Select **See all results** at the bottom of the list, or press **Enter**
without picking a result. The results page lists everything that matched, and
**Load more** shows the next results.

Narrow the results with **Filters**:

| Filter | Keeps |
|---|---|
| **Kind** | Spec files, tasks, attachments or the project |
| **Spec file type** | One type, such as requirements or tasks |
| **Folder** | Spec files in one bundle or folder |
| **Task status** | Pending, in progress or done tasks |
| **Assignee** | Tasks assigned to you (**Me**) or to someone else |
| **Task label** | Tasks with one label |

Select **Clear filters** to start again. The page address includes your search
and filters, so you can bookmark it or send it to a teammate. They see only
the results their own access allows.

## Who sees what

Search shows only what you can already open in the project:

- You can search a project only if you can open it.
- Results come only from what your project role lets you read. See
  [Teams and project access](https://docs.myspec.dev/guides/teams-and-project-access/).
- Read-only API tokens can search too.

## How fresh results are

- A new or changed spec file or attachment shows in search **within about a
  minute**. If a change is ever missed, a background check catches it up
  **within an hour**.
- Tasks, names, folders and paths are always current: a renamed bundle shows
  at its new path, and a file moved to the **Trash Bin** disappears from
  results at once.

## Troubleshooting

| You see | What to do |
|---|---|
| **Type at least 2 characters to search.** | Keep typing. |
| **Type a word or phrase to search for.** | The search has only punctuation, or only excluded words (`-draft`). Add a word to look for. |
| **No results for "…".** | Check the spelling, remove a word, or remove quotes. On the results page, select **Clear filters**. |
| **Search failed.** | Select **Try again**. |
| **Search is unavailable in this project right now.** | Search is not available for you here. Try again later. |
| A file you just changed is not found yet | Wait a minute and search again. |
| A PDF file or an image is not found by its content | Search for its name. Their text is not searched. |

Source: https://docs.myspec.dev/guides/search/index.mdx
