Layer shifting in 3D prints: causes and fixes
A layer shift is when part of a print is suddenly offset sideways from the layers below it, because a motor skipped steps or a belt or pulley slipped. Check the pulley grub screws and belt tension first, then look for anything the nozzle could hit, then lower acceleration and make sure the stepper drivers aren't overheating.
- Power off and tighten the pulley grub screws on the X and Y (or A and B) motors.
- Check belt tension: firm with a low note when plucked, and equal on both CoreXY belts.
- Look for collisions: curled edges, snagged cables or filament, parts left on the bed.
- Lower acceleration 25–50% for one test print.
- Make sure the electronics fan spins and the board isn't cooking inside a hot enclosure.
Diagnose the layer shift from the print
Where and how a print shifts tells you a lot. Keep the failed print and compare it to this table before taking anything apart.
| What you see | Most likely cause | Go to |
|---|---|---|
| One clean step, and the rest of the print carries on offset | Skipped steps from a collision or a too-fast move | Collisions, acceleration |
| Several steps in the same direction (a "staircase") | Loose pulley on that axis's motor | Pulley grub screws |
| Shifts on a diagonal on a CoreXY printer | One of the two motors or belts (A or B) | Belts and pulleys on that motor |
| Shift at the same height in every attempt | Something in the G-code at that layer | Collisions; check the file in a G-code viewer |
| Shifts only late in long prints or in a warm room | Stepper drivers overheating | Drivers and current |
| Clicking or grinding from a motor as it shifts | Motor skipping steps: too much acceleration, binding or low current | Acceleration, binding |
| Small random shifts on a tall print on a bed-slinger | Heavy part on a moving bed, plus high Y acceleration | Acceleration |
If layers look squashed together or have gaps vertically rather than being offset sideways, that's a Z-axis problem (a binding lead screw or loose coupler), not a layer shift.
1. Check and set belt tension
A loose belt can jump a tooth on the pulley under load, which shifts the print by a fixed amount (2 mm per tooth on standard GT2 belts). An over-tight belt wears bearings and makes the motor work harder.
- Power off and move the toolhead to the middle of its travel.
- Pluck the belt like a guitar string. It should give a low, short note and feel firm, not floppy.
- On CoreXY printers, compare both belts. They should sound and feel the same. Prusa notes that shifts on one diagonal point to the motor and belt for that diagonal.
- Use a measured value if you can. Prusa offers a belt tuner app for its printers, and Voron targets about 110 Hz over a 150 mm span on its A and B belts, measured with a phone spectrum app.
- Check the belt itself for frayed edges, missing teeth or a slipping clamp at the toolhead or bed.
- Re-run input shaping or vibration calibration after any tension change, because it alters the printer's resonances.
Don't overdo it: cranking belts guitar-string tight bends motor shafts and wears idler bearings. Tighter than spec isn't better.
More detail in belt tension and calibration.
2. Tighten the pulley grub screws
Each X and Y motor has a toothed pulley held on by one or two tiny grub (set) screws. If one loosens, the motor shaft spins but the pulley lags behind, and the print shifts. Prusa calls this the most common cause of repeated shifts in the same direction.
- Power off. Find the pulley on each motor, usually behind a cover on enclosed printers.
- Try to turn the pulley while holding the motor. It should not move independently of the shaft at all.
- Draw a marker line across the pulley and shaft. If the line has split after a print, the pulley is slipping.
- Tighten both grub screws (usually a 1.5 mm hex key). One should sit on the flat of the motor shaft.
- Optional: a drop of medium-strength (blue) threadlocker on screws that keep loosening. Avoid high-strength (red) threadlocker; you'll want to undo them again someday.
3. Stop the nozzle from hitting things
If the nozzle catches on the print hard enough, it stalls the motor and the rest of the print lands in the wrong place. Common culprits:
- Curled overhangs or warped corners sticking up into the nozzle's path. Fix the cooling or warping.
- Over-extrusion building up ridges the nozzle drags across. See over-extrusion.
- Travel moves across the part. Turn on "avoid crossing walls/perimeters" or a small Z-hop (around 0.2 mm).
- Snags: cables, the filament tube or loose filament catching on the frame. Prusa specifically mentions filament wrapped around the Y pulley.
- Debris on the bed such as purge blobs or a forgotten part.
If the shift happens at the same height every time, the cause is almost always at that layer of the file. Open it in the G-code viewer, jump to that layer and turn on travel moves to spot the collision.
4. Check stepper driver current and overheating
Stepper drivers shut down or reduce power briefly when they overheat, and the motor skips steps while they do. Prusa's advice for driver overheating errors:
- Keep the electronics cool. Check the board fan spins and isn't clogged with dust. Don't put the electronics inside a heated enclosure.
- Watch the room temperature. Shifts that only happen in summer, or in a closed cabinet, point here.
- Check the wiring. Reseat motor connectors and look for damaged cables at flex points.
- Reflash the firmware if you've set custom motor currents and aren't sure of them.
On Prusa printers, Normal mode gives the motors more headroom than Stealth (quiet) mode, and crash detection only works in Normal mode. Prusa suggests Normal for large prints.
On DIY or upgraded printers where you set the driver current yourself (A4988, DRV8825, TMC2208 and TMC2209 boards), too little current means skipped steps and too much means hot drivers and motors. Set it from the motor's rated current.
Free PrintPal toolStepper Motor Vref CalculatorWork out a safe Vref or driver current for your driver and motorOpen tool5. Lower acceleration and speed
A motor only has so much torque. Ask it to accelerate a heavy toolhead or bed too hard and it skips steps. Speed matters too, because stepper torque drops as they spin faster.
Input shaping doesn't add torque: input shaping (Klipper, Prusa) and vibration compensation (Bambu Lab) cancel ringing so you can use higher acceleration without ghosting. They don't make the motors stronger. Klipper's SHAPER_CALIBRATE also suggests a maximum acceleration for each shaper to avoid over-smoothing details; treat that as an upper limit, not a target.
| Printer type | Typical acceleration | If it shifts |
|---|---|---|
| Older bed-slinger on stock Marlin (Ender 3-class) | Around 500–1,000 mm/s² | Return to the stock profile; check belts and current before raising it |
| Bed-slinger with input shaping (for example the Bambu Lab A1 series, rated to 10,000 mm/s²) | Manufacturer profile | Cut Y acceleration for tall or heavy parts |
| Enclosed CoreXY with input shaping (for example the Elegoo Centauri Carbon 2 or Bambu Lab H2D, rated to 20,000 mm/s²) | Manufacturer profile | Try the printer's Silent speed mode or a lower-acceleration profile, and look for mechanical causes |
| Klipper DIY build | Up to the SHAPER_CALIBRATE suggestion | Drop 25–50% and re-test |
On small parts, very high acceleration often buys little: the toolhead never reaches full speed on short moves anyway.
Free PrintPal toolAcceleration Distance CalculatorSee how far the toolhead travels before it reaches the speed you setOpen tool6. Remove binding and friction
With the printer off, push the toolhead and bed by hand along each axis. They should glide smoothly with even resistance end to end.
- Rods and rails: clean and lubricate per the manufacturer (Prusa lists lubrication in its layer-shift checklist).
- V-slot wheels (Ender 3-style printers): adjust the eccentric nuts so the wheels just grip the rail. Too tight binds; too loose wobbles.
- Idlers and bearings: spin them with a finger. Gritty or noisy means replace.
- Obstructions along the full travel, including the cable chain and anything behind the printer.
The maintenance schedule has a routine for all of this.
Your print has four small shifts, all toward the left on the X axis, at random heights. What do you check first?
Repeated shifts in one direction on one axis are the classic sign of a pulley slipping on its motor shaft. Tighten both grub screws, with one on the shaft's flat.
Frequently asked questions
What causes layer shifting in 3D printing?
A layer shift happens when a motor skips steps or a belt or pulley slips, so the printer loses track of where the nozzle is. The common causes are loose belts or pulley grub screws, the nozzle hitting the print, acceleration or speed that is too high for the motors, and overheating stepper drivers.
Why does my print shift at the same height every time?
Something at that height in the G-code is triggering it, such as a fast travel move across the part, a collision with a feature that starts there, or a curled overhang. Open the file in a G-code viewer, go to that layer and look at the travel moves.
Can high acceleration cause layer shifts?
Yes. If the motors can't deliver the torque a move demands, they skip steps. Input shaping reduces vibration but does not add torque, so drop acceleration by 25–50% as a test; if the shifts stop, settle on a value just below where they started.
How tight should 3D printer belts be?
Firm enough to pluck with a low note, but not guitar-string tight. Use your printer maker's tension value or tool if it has one; Voron, for example, targets about 110 Hz over a 150 mm span. On CoreXY printers, both belts should be tensioned equally.
Related articles
Sources & further reading
- Prusa Knowledge Base — Layer shifting
- Prusa Knowledge Base — TMC driver overtemp
- Prusa Knowledge Base — Crash detection
- Voron Design — Secondary printer tuning (belt tension)
- Klipper documentation — Measuring resonances
Tools for thisAll tools
Thanks! We read every note and use them to decide what to update next.