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:
resumefinds “résumé”, andtim kiemfinds “tìm kiếm”. - Other forms of a word count too:
authenticatefinds “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.
- 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. |