Articles on: SimplyPrint features

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

Was this article helpful?

Share your feedback

Cancel

Thank you!