> For the complete documentation index, see [llms.txt](https://documentation.ocsinventory-ng.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.ocsinventory-ng.org/user-docs/console-tools/saved-searches.md).
# Saved searches
Saved searches are **pre-built searches** that allow you to reuse complex searches without having to rebuild them each time. They can be created, replayed, and managed from the OCS console.
## Creating a search
{% stepper %}
{% step %}
Navigate to the **Multi-criteria search** page**.**
Go to **Inventory → Tools → Multi-criteria search**.
{% endstep %}
{% step %}
Build your search.
Construct the search you want to save by defining the criteria.
{% endstep %}
{% step %}
Save the search.
* Click the **green disk icon** in the top-right corner.
* Complete the form:
* **Action**: either create or update an existing search.
* **Name**
* **Description**
* **Visibility**: public, private or by groups
{% endstep %}
{% step %}
Click **Add** to save your search.
Your search is now saved.
{% endstep %}
{% endstepper %}
## Reusing a search
Now that you managed to create a saved search, we will see how to use it.
{% stepper %}
{% step %}
**Navigate to the Multi-criteria search page.**
Go to **Inventory → Tools → Multi-criteria search**.
{% endstep %}
{% step %}
Access **Saved searches.**
* Click the **yellow star icon** in the top-right corner.
* A window will open, displaying all your saved searches.
{% endstep %}
{% step %}
Load the search**.**
* Click on the name of the search you want to use.
* The search page will refresh and display the results for the saved search.
{% endstep %}
{% endstepper %}
## Managing saved searches
The **Saved Searches Management Page** can be accessed via:
* The **Multi-criteria Search page**: Open the "Use a saved search" window (click the **yellow star icon**) and click the **gear icon**.
* Directly from **Inventory → Tools → Saved Searches**.
Saved searches view
### Editing a search
{% stepper %}
{% step %}
Locate the saved search you want to edit.
{% endstep %}
{% step %}
Click the **pencil icon** in the **Actions** column.
{% endstep %}
{% step %}
Update the search metadata:
* **Name**: Edit the search's name.
* **Description**: Update its description.
* **Visibility**: Adjust access permissions.
Saved search edit form
{% endstep %}
{% step %}
#### Click **Save** to apply changes.
{% endstep %}
{% endstepper %}
### Removing a search
{% stepper %}
{% step %}
Locate the saved search you want to delete.
{% endstep %}
{% step %}
Click the **trash icon** in the **Actions** column.
{% endstep %}
{% step %}
Confirm the deletion when prompted.
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://documentation.ocsinventory-ng.org/user-docs/console-tools/saved-searches.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
