> For the complete documentation index, see [llms.txt](https://docs.labatlas.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.labatlas.com/using-lab-atlas/search.md).

# Search

Finding projects, studies, assays, and notes across your organization

Search finds projects, studies, assays, and notes across your whole organization from one box. It matches more than names: descriptions, keywords, aliases, team members, and the external records linked to each project, study, or assay are all searched too.

## Running a search

The search box sits at the top of every page, in the navigation bar. Type a term and press Enter to open the **Search** page with your results.

On a narrow screen the box is replaced by a magnifying-glass icon. Tap it to open the **Search** page, which has its own search field.

The **Search** page keeps a search field at the top, already filled with your current term. Change the term and click **Search** to refine it, or click the **×** button to clear it.

{% hint style="info" %}
The search term and the active filter are part of the page address. You can bookmark a search, refresh it, or send the link to a colleague, and it opens on the same results. Each person only sees the results they have access to.
{% endhint %}

## What is searched

| Record       | What is matched                                                                                                                                                             |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Projects** | Name, code, description, status, owner and team members, external links, and linked ELN and registry records                                                                |
| **Studies**  | Name, code, description, status, aliases, keywords, collaborators, owner and team members, its project's name and code, external links, and linked records                  |
| **Assays**   | Name, code, description, status, aliases, keywords, assay type, metadata field values, collaborators, owner and team members, its study, external links, and linked records |
| **Notes**    | Title, content, keywords, and authors                                                                                                                                       |

A few things to know:

* **Keywords belong to each record.** An assay doesn't inherit its study's keywords, so searching for a study's keyword won't return its assays unless they carry the same keyword.
* **Linked records are searched by name and ID.** If a Benchling sequence, a CDD Vault molecule, or a SoftMouse mouse is linked to a study, searching for that record's name or ID returns the study. ELN notebook folders and entries attached to a record work the same way. See [Linked records](#linked-records) below.
* **Notes are searched at their latest saved version.**
* **Archived records and archived notes are not searched.** Restoring a record makes it searchable again.

## Reading your results

Results are ranked by relevance, with the best match first. A line above the list shows how many results matched, for example *3 results for "PPB-101"*.

Each result shows:

* A badge for the record type: **Project**, **Study**, **Assay**, or **Note**.
* The record's code, and the record it sits in. A study shows its project, an assay shows its study, and a note shows the record it belongs to. Click any of these to open it.
* The record's name, which opens the record.
* Up to three snippets that show **why** it matched. Each snippet is labelled with the field that matched, such as **Description**, **Keywords**, or **Linked ELN record**, and the matching words are highlighted.

Click **Show details** under a result to see more about the record without opening it, such as its status, project, assay type, aliases, keywords, and how many linked records it has. Empty fields are left out. Click **Hide details** to collapse it again.

## Filtering results

Chips above the results narrow them by type: **All**, **Projects**, **Studies**, **Assays**, and **Notes**. Each chip shows how many results it holds. A chip with no matching results is greyed out and can't be selected.

If you pick a type and nothing in it matches, Lab Atlas tells you which other types did match and offers buttons to switch to them, or to show all results.

## What you can see

Search only returns records you already have access to. You see results from projects you can view, and from the studies, assays, and notes inside them. Records in protected or private projects you aren't a member of are never shown.

Organization Admins and Account Admins see results from every project in the organization. They are also the only people who see organization-wide notes (notes that don't belong to a project, study, or assay) in search.

Other members' **Draft** records are hidden from search, along with anything inside them, just as they are hidden from the project, study, and assay lists. Your own drafts do appear. See [Planning](https://docs.labatlas.com/using-lab-atlas/planning.md) for more about drafts.

## Search states

| What you see                      | What it means                                                                                                  |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| *Search across your workspace*    | You haven't entered a search term yet.                                                                         |
| *Nothing matched "…"*             | Nothing you have access to matched. Check the spelling or try a broader term.                                  |
| *No … matched this search*        | The type you filtered on is empty, but other types matched. Use the buttons to switch.                         |
| *Search is unavailable right now* | Lab Atlas couldn't reach the search service. Your data is unaffected. Click **Try again**, or come back later. |

## Linked records

Linking an external record to a project, study, or assay keeps everything tied to that work in one place, and makes the record findable through search. You can link records from any connected integration that supports linking: for example Benchling sequences and custom entities, CDD Vault molecules and protocols, and SoftMouse mice and cages.

Linked records live on the **ELN** tab of a project, study, or assay.

{% stepper %}
{% step %}

### Open the ELN tab

Open the project, study, or assay and click the **ELN** tab. The **Electronic Lab Notebook** card lists the notebook folders, entries, and records already linked to it.
{% endstep %}

{% step %}

### Start a search

Click **Add**, then **Search All**. The **Link Entity** dialog opens.
{% endstep %}

{% step %}

### Choose where to look

Under **ELN Integration**, choose the connected integration to search. Then choose an **Entity Type**, such as a molecule or a mouse. The types offered depend on the integration.
{% endstep %}

{% step %}

### Find and select records

Type in the **Search** box and press Enter, or click the search button. Tick each record you want to link. Click **(open)** next to a result to check it in the other system first.
{% endstep %}

{% step %}

### Link them

Click **Link 1 Item** (the count follows your selection). The records appear in the card.
{% endstep %}
{% endstepper %}

Use **Filter** on the card to show only certain sources or types. To open a linked record in its own system, click the **⋯** menu on its row and choose **Open in ELN**. To unlink it, choose **Remove**. Removing a link doesn't delete anything in the other system.

{% hint style="info" %}
You can link records only if you can edit the project, study, or assay. You can't link records to an archived or [locked](https://docs.labatlas.com/using-lab-atlas/locking-records.md) record, or to one that hasn't been activated yet. The **ELN** tab doesn't appear on Draft and In Planning records. See [Activating Records](https://docs.labatlas.com/using-lab-atlas/planning/activating-records.md).
{% endhint %}

## For administrators

Search is available on the Professional and Enterprise plans. When it isn't available to your organization, the search box doesn't appear in the navigation bar.

Search also relies on a search service that runs alongside Lab Atlas. If it is turned off for your installation or can't be reached, the **Search** page shows *Search is unavailable right now*. Nothing else in Lab Atlas is affected.

Organization Admins can choose to see other members' drafts. Turn on **Include other members' drafts** on the Projects, Studies, or Assays list, and search follows the same setting in that browser.

Linking records needs at least one connected integration that supports linking. Organization Admins connect these from the **Integrations** page. See [Third-Party Connectors](https://docs.labatlas.com/managing-your-organization/third-party-connectors.md).
