Printer search and filtering: how it works, filter list & more

Written By Albert Møller Nielsen

Last updated About 6 hours ago

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`
`tags`	string	yes	Custom tag names	`tags:my_custom_tag`

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!