Printer search and filtering: how it works, filter list & more
Printer Search & Filtering: How It Works
With our printer search bar, you can combine free-text search (e.g. “Bambu Lab”) and filters (e.g. status:printing
). This article covers how to use both, how the clickable top “cards” apply filters automatically, and provides a full filter list.
---
1. Combining Free Search & Filters
- Free-text search covers printer ID, printer name, model name, brand, and if printing, the job filename.
- You can type plain text (e.g. a printer brand name) and add filters such as
status:printing
. - Only printers matching all criteria appear.
For example:status:printing Bambu Lab
…will show only Bambu Lab printers whose status is “printing.”
2. Filters in the URL (Bookmarkable & Persistent)
Your search (filters + free-text) is appended to the URL, so if you refresh the page or bookmark it, your current view persists.
For example: simplyprint.io/panel/printers#filters:status:ready
…will load only “ready” printers right away.
3. Clickable Top Cards (Print Farm plan)
At the top, you may see cards like “Idle & ready”, “Ongoing”, “Paused,” etc. Clicking a card applies that corresponding filter automatically.
- Clicking again removes that filter.
- Clicking a different card removes the previous filter and applies the new one.
4. Filter List
Below is every filter, whether multiple values are allowed (comma-separated), and the data type it accepts:
Filter | Type | Multiple | Acceptable values | Example usage |
---|---|---|---|---|
| number | yes | Printer ID(s) | |
| string | yes | | |
| string | yes | Group name or ID | |
| bool | no | | |
| bool | no | | |
| bool | no | | |
| bool | no | | |
| bool | no | | |
| bool | no | | |
| number | no | e.g. | |
| bool | no | | |
| string | yes | e.g. | |
| string | no | e.g. | |
| bool | no | | |
| bool | no | | |
| bool | no | | |
| string | yes | Printer brand, partial matches OK | |
| string | yes | Printer model, partial matches OK | |
| string | yes | e.g. | |
| string | no | e.g. | |
| string | yes | Custom tag names | |
| bool | no | | |
| bool | no | | |
| bool | no | | |
| number | no | e.g. | |
| number | no | e.g. | |
| bool | no | | |
| number | no | e.g. | |
| number | no | e.g. | |
| number | no | e.g. | |
| bool | no | | |
| bool | no | | |
| number | no | e.g. | |
| string | no | e.g. | |
| string | no | | |
| bool | no | | |
| string | no | Machine name, partial matches OK | |
| string | no | e.g. | |
| bool | no | | |
| bool | no | | |
| number | no | e.g. | |
Bool fields accept true
, false
, 1
, 0
, yes
to mean true or false.
5. Keyboard Navigation & Suggestions
As you type, suggested filters or values appear. You can:
- Use arrow keys to highlight a suggestion.
- Press Enter to insert it into the search bar.
- Continue typing or hit enter again to run the search.
That’s it! Happy filtering!
Updated on: 14/01/2025
Thank you!