# Search & Filters

Homepage search finds boards, folders, and teamspaces across everything you have access to. It supports keyword search plus attribute filters so you can narrow quickly when the keyword alone isn't specific enough.

## Where to Search

The search box sits at the top of the YouDesign Models homepage. Next to it is a **filter icon** that opens a popover where you can build more specific queries.

<figure><img src="/files/if1oU4O4ZgpJJNJZb7mJ" alt=""><figcaption></figcaption></figure>

## Typing a Query

1. Click the search input and type your keyword.
2. As you type, results are searched with a **short debounce** (about 1 second) so the page doesn't flicker on every keystroke.
3. Matching boards, folders, and teamspaces appear in the results list.

## Filters

Click the filter icon to open the filter popover. You build a filter in three choices:

1. **Type** — scope the results:
   * Board
   * Folder
   * Teamspace
2. **Attribute** — the field you want to filter on:
   * **Type** (board type like Capability Map, Process Map, etc.)
   * **Organization**
   * **Owned by**
   * **Editor**
   * **Reader**
3. **Values** — the specific values for the chosen attribute (for example, specific owners or organization records).

When you pick **Organization** as the attribute, an extra **Organization Table** dropdown appears so you can tell the filter which organization table to draw values from.

Click **Apply** to add the filter.

## Active-Filter Pills

Every filter you apply shows up as a **pill** beneath the search box:

* Each pill describes the filter (e.g., *"Owned by: Kadir"*)
* Click the × on a pill to remove that filter
* Clearing all pills returns the full result list

## Combining Text + Filters

Search text and filters work together. A common pattern:

1. Type a keyword like *"capability"*
2. Apply a filter *Type = Board*
3. Apply a filter *Owned by = \[your name]*

The results now only show boards owned by you whose content matches *"capability."*

> **Tip:** Some filters require a search query to be effective. If you see the tooltip *"Some of the filters are not applied, because there is no search query,"* type a keyword in the search box to activate them.

## Roles & Visibility

Homepage search respects your access rights. Results never include boards, folders, or teamspaces you don't have permission to see.

## Limits & Gotchas

* **Debounced input.** Expect a \~1 second delay between typing and updated results.
* **Filter chain order matters.** Pick Type first, then Attribute, then Values — some Attribute options depend on Type.
* **Lifecycle filter is not available** in the current version. It may return in a later release.
* **Filter values are scoped to what you can see** — you won't be offered an owner or editor you don't have access to.

## Related

* [Teamspaces](/models/work-in-the-app/homepage/teamspaces.md)
* [Folders](/models/work-in-the-app/homepage/folders.md)
* [Sharing & Members](/models/work-in-the-app/homepage/sharing-and-members.md)
* [Canvas Search](/models/work-in-the-app/editor/search.md) — for searching *inside* a single board


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ins-pi.com/models/work-in-the-app/homepage/search.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.