3D printer error code lookup: Bambu, Prusa, Creality, Klipper and Marlin

Type your code or message into the table filter below to see what it means and what to try first. Bambu Lab uses 16-digit HMS codes such as 0300-0200-0001-0007; Prusa uses five-digit codes where the first two digits are the printer (13204 is an MK4); Creality OS uses two letters and four digits (TE2509); Klipper and Marlin show plain-text messages. Every code here was checked against the manufacturer's own documentation.

Search 3D printer error codes and messages

The filter matches any text in a row. Type Bambu codes with their dashes (0300-0200-0001-0007) or search one block such as 0001-0007. For Prusa, search the full code (31204) or just the last three digits (204), since the first two digits only identify the printer.

How to read Bambu Lab HMS error codes

Bambu Lab printers use two kinds of code. HMS codes (Health Management System) have 16 hex digits in four blocks, such as 0300-0200-0001-0007, and appear in the printer's Assistant or HMS list. Error codes have 8 digits, such as 0300-8007, and pop up on the main screen.

• The first block is the module. 0300 is the printer itself (motion, hotend, bed, fans), codes starting 07 come from the AMS, and 0C00 codes come from camera-based inspection.
• Colour shows severity. Blue is a prompt, orange pauses the print, and red stops it.
• Where to see them: on the X1 series, open the Assistant (it shows a QR code); on the P1 series, codes scroll on the home screen; on the A series, tap the assistant icon at the bottom right.
• Where to look them up: scan the on-screen QR code, or search the HMS page on Bambu's wiki. Each code also has its own page whose address ends in the code with underscores, for example 0300_0200_0001_0007.

On dual-nozzle printers such as the H2D, some hotend codes refer to a specific extruder (Bambu labels 0200 codes as the right one), so check which side the message names.

How Prusa error codes work (XXYZZ)

Prusa's 32-bit printers run Buddy firmware (MK4, MK4S, CORE One, XL, MINI, MK3.9 and MK3.5) and show a five-digit code with a QR code on the error screen. The format is XXYZZ: XX is the printer, Y is the category and ZZ is the specific error. So 31204 is a CORE One (31), temperature category (2), print head thermal runaway (04).

To look up any code, scan the QR code on the screen, or go to Prusa's help site and search the number. The older MK3S+ (8-bit) firmware shows text messages such as THERMAL ANOMALY instead of numbers.

Creality error codes (K1, K2, Hi and Creality OS printers)

Creality OS printers show two letters followed by four digits, such as TE2509. The letters identify the module and the digits identify the fault. Some K1 screens show only the number, for example "Error Key: 2509", which is the same fault as TE2509. Creality publishes the full list on its wiki, linked in the sources below.

Older Marlin-based Ender printers don't use these codes. They show Marlin messages like Err: MINTEMP, which are in the table above.

Klipper error messages and what they mean

Klipper errors fall into two groups, and the fix depends on which one you have:

• MCU shutdowns read MCU 'mcu' shutdown: <reason>. The printer board has stopped for safety. Klipper prints a hint under the message; fix the cause, then send FIRMWARE_RESTART.
• Command errors such as Move out of range: X Y Z [E] or Must home axis first reject one command. In a print, they usually mean the sliced file doesn't match your printer's limits or start G-code.

Move out of range lists the exact coordinates that were rejected. Open the file in a G-code viewer to find which move goes past the edge; it's often a purge line or a model placed off the bed.

Marlin error messages (Ender 3 and other Marlin printers)

Marlin shows short messages on the screen and longer ones on the serial console. Temperature faults end in PRINTER HALTED and Please Reset, and only a reset or power cycle clears them; M999 won't. The serial version names the heater, for example Error:Thermal Runaway, system stopped! Heater_ID: E0. For the details on each, see the MINTEMP and MAXTEMP guide and the thermal runaway guide.

How to report an error to support

Support teams solve problems much faster with the right details. Collect these before you get in touch:

• A photo of the screen showing the full code and message.
• Printer model and firmware version (in the printer's settings or info menu).
• What the printer was doing: heating, homing, the first layer or a later layer, and roughly how far into the print.
• Filament type, slicer and profile, and anything you changed recently (nozzle, hotend, firmware).
• Klipper: download klippy.log from Mainsail or Fluidd and attach it; it records the shutdown reason and your config.
• Marlin: copy the serial console output, especially the line starting Error:.

Frequently asked questions

Related articles