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 |
|---|---|---|---|---|
| id | number | yes | Printer ID(s) | id:10, id:10,12 |
| status | string | yes | printing, operational, offline, error, cancelling, paused, pausing, resuming, unknown | status:printing |
| group | string | yes | Group name or ID | group:my_printer_group |
| awaiting_bed_clear | bool | no | true / false / 1 / 0 / yes | awaiting_bed_clear:true |
| ai_enabled | bool | no | true / false etc. | ai_enabled:false |
| ai_running | bool | no | true / false etc. | ai_running:true |
| ai_warning | bool | no | true / false etc. | ai_warning:true |
| autoprint_enabled | bool | no | true / false etc. | autoprint_enabled:true |
| autoprint_cycles_to_reset | bool | no | true / false etc. | autoprint_cycles_to_reset:true |
| nozzle | number | no | e.g. 0.4 | nozzle:0.6 |
| has_material | bool | no | true / false etc. | has_material:false |
| material_type | string | yes | e.g. pla, abs, petg | material_type:pla,abs |
| material_color | string | no | e.g. blue, red, black | material_color:blue |
| device_health_throttled | bool | no | true / false etc. | device_health_throttled:false |
| has_webcam | bool | no | true / false etc. | has_webcam:true |
| out_of_order | bool | no | true / false etc. | out_of_order:true |
| brand | string | yes | Printer brand, partial matches OK | brand:prusa |
| model | string | yes | Printer model, partial matches OK | model:mk3s,bambu |
| printer_api | string | yes | e.g. octoprint | printer_api:octoprint |
| firmware | string | no | e.g. marlin, repRap, klipper | firmware:marlin |
| tags | string | yes | Custom tag names | tags:my_custom_tag |
| has_filament_sensor | bool | no | true / false etc. | has_filament_sensor:true |
| filament_sensor_has | bool | no | true / false etc. | filament_sensor_has:true |
| has_heated_bed | bool | no | true / false etc. | has_heated_bed:true |
| nozzles_count | number | no | e.g. 2 | nozzles_count:2 |
| extruder_count | number | no | e.g. 1 | extruder_count:1 |
| slicer_support | bool | no | true / false etc. | slicer_support:true |
| max_tool_temp | number | no | e.g. 300 | max_tool_temp:300 |
| max_bed_temp | number | no | e.g. 100 | max_bed_temp:100 |
| filament_diameter | number | no | e.g. 1.75 | filament_diameter:1.75 |
| has_auto_bed_leveling | bool | no | true / false etc. | has_auto_bed_leveling:true |
| bed_belt | bool | no | true / false etc. | bed_belt:true |
| max_height | number | no | e.g. 250 | max_height:250 |
| bed_size | string | no | e.g. 200x200, 180,180 | bed_size:180x180 |
| bed_type | string | no | circle, square, rectangle | bed_type:square |
| has_assigned_spool | bool | no | true / false etc. | has_assigned_spool:true |
| machine | string | no | Machine name, partial matches OK | machine:my_machine |
| software_version | string | no | e.g. 1.2.3 | software_version:1.2.3 |
| has_psu | bool | no | true / false etc. | has_psu:true |
| psu_on | bool | no | true / false etc. | psu_on:false |
| active_tool | number | no | e.g. 1 | active_tool:1 |
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!