> For the complete documentation index, see [llms.txt](https://help.steeple.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.steeple.com/en/support/recherche-globale.md).

# How do I use search in Steeple?

### Introduction

The **global search** Steeple finds, from a single field, collaborators, Posts, conversations and messages, events, Documents, Jobs, Shortcuts, articles, radio episodes and wiki pages.

### Open search

* The button **Search** (magnifying glass) in the navigation bar opens search in a window, over the current page
* Keyboard shortcut: **⌘ K** on Mac, **Ctrl K** on other computers. The same shortcut closes the window
* **Esc**, or a click outside the window, closes it
* In a community, the magnifying glass **Search in the community** opens the same search, already filtered on this community
* Clicking on a **#hashtag**, in a post or message, opens search with that hashtag already entered

Search also has its own page, at `/app/search`. A link like `/app/search?q=bilan` opens the search for the word “bilan” directly. The old address `/search` redirects to this page.

### What can be searched

Results are grouped by category, always in this order:

| Category          | What is searched                                               |
| ----------------- | -------------------------------------------------------------- |
| **Collaborators** | The name                                                       |
| **Sections**      | The section name                                               |
| **Posts**         | The title and text                                             |
| **Conversations** | The conversation name, and for a group the name of its members |
| **Messages**      | The text of messages and poll question                         |
| **Events**        | The title                                                      |
| **Folders**       | The folder name                                                |
| **Documents**     | The file name and its summary                                  |
| **Jobs**          | The title                                                      |
| **Shortcuts**     | The name and URL of the link                                   |
| **Feeds**         | The feed title                                                 |
| **Articles**      | The title and text                                             |
| **Episodes**      | The episode title                                              |
| **Wiki**          | The title and content of pages                                 |

{% hint style="info" %}
Search only shows what you are allowed to see: each application applies its own access rules. An application hidden by your organization's administration does not appear in the results, and the categories **Episodes** and **Wiki** only exist if your organization has Radios and Wiki.
{% endhint %}

Communities are no longer a category of results: they serve as a **filter** (see below).

### Read the results

* The tab **All** shows the first two results of each category. **See all (N)** opens the full category
* A tab per category appears as soon as it has results; the rest loads as you scroll
* Each result displays an image or an icon, its name, a detail (excerpt, location, file size…) and its date. The searched words are highlighted
* Clicking a result opens it: a collaborator's profile, the conversation at the message's location, the document… A shortcut to an external site opens in a new tab
* On a collaborator, the button **Send a message** opens a conversation with them directly

### Filter

The button **Filter**, next to the search field, displays three filters:

* **Communities** : keeps only content from the selected communities. Your communities appear first; **See all communities** shows the others
* **From** : keeps only content written by the selected people
* **When?** : keeps only content from a period: last 7 days, last 30 days, last 6 months, this year, or custom dates (**From**, **To**)

The filters **From** and **When?** are enough to start a search, even without text. They exclude the categories **Collaborators** and **Sections**, which have neither author nor date; the filter **From** also excludes **Episodes**.

When a filter is active, the button becomes **Reset** : it clears the filters and keeps the entered text.

### Good to know

* Search starts from **3 characters**, as soon as you pause typing
* It ignores uppercase letters and, for most content, accents
* **Recent searches** : before you type, the window suggests your last 5 searches. An X removes a search, **Clear all** empties the list. They are saved in the browser you use
* On a shared display screen, no search is saved
* If a category takes a long time to respond, the others display without waiting for it. Search automatically retries (**Retrying...**) ; if it still fails, the button **Error, try again** restarts the category

### What the assistant can do

The assistant doesn't use global search. Depending on the active scope, it searches a given application: collaborators (Directory), events (Events), documents (Documents)… With the Documents and Wiki scopes, it can also answer from the **content** of the documents and wiki pages you can access.