OrcaSlicer Color Change at a Specific Layer
In OrcaSlicer you change color at a specific layer by inserting a color change at that layer in the preview, or by assigning a second filament to an object or a height range on a multi-material machine. On a single extruder the printer stops and waits for you to swap the spool; on an AMS or MMU system it switches tools by itself. Choose the method before you slice, because the two are set up in different places.
The change is stored as a layer height, not as a feature of the model. A detail that spans several layers, a top surface, or a hole that opens at that height will change color along with everything else on that layer. Check the preview at the exact layer before you commit a long print.
First check
Does your printer and firmware handle a mid-print pause or a tool change reliably?
Second check
Find the first layer that should be the new color, and treat it as a height, not a feature.
Third check
Purge enough at the swap that the old color does not bleed into the new one.
Tip: Confused by a control name? OrcaSlicer renames and regroups controls between versions. Match a control by what it does rather than by its label, and confirm the current name in your own build.
Method Chooser
Find your setup in the left column. It decides which method you use and what has to be ready before you slice.
| Your setup | Method | What has to be ready before you slice |
|---|---|---|
| Single extruder, you will swap the spool by hand | Insert a color change at the layer | A pause or filament-change command written at that layer, and the second spool loaded and mapped so the machine can actually switch to it. |
| Single extruder, nobody will be at the machine when it stops | Pause at the layer and resume later | A pause command at the layer, and a machine that can sit paused and resume safely — check the printer's manual before you rely on it. |
| AMS, MMU, or another multi-material system | Assign the second filament to an object or a height range | A second filament slot that is physically loaded, the flush volume between the two colors, and a prime tower where your profile uses one. |
| Multi-material, and the change follows a height | Height range modifier | A modifier that covers the layers above the change height, with the second filament assigned to it. |
| Multi-material, and the change follows one part | Per-object filament assignment | The second filament slot, plus a check that the switch does not strand the prime tower or skip the purge. |
| Only one color is loaded | Load the second color first | Nothing in the slicer substitutes for a second spool that is really loaded and mapped to the right slot. |
If two rows fit, choose the one that matches the hardware you actually have. A command the firmware does not honour will not produce a clean color change, no matter how the layer is placed.
Control Chart
These are the OrcaSlicer controls that decide where the change lands and how clean the transition looks. Work down the list.
| Control | What it changes | Safe direction | Caution |
|---|---|---|---|
| Color change at a layer | Writes a filament change at the layer you pick | Pick the first layer that should be the new color | It is a Z height, not a feature, so everything on that layer changes with it. |
| Pause at a layer | Stops the print at that layer and waits for you | Use it when you are swapping by hand | A paused machine may hold the nozzle at temperature; check how your profile parks and cools before you walk away. |
| Filament change G-code | The command the printer runs when the swap happens | Leave the profile's shipped command unless you know your firmware needs something different | The wrong command for the firmware means the machine ignores the stop or keeps printing through it. |
| Filament and extruder mapping | Which physical spool each filament slot uses | Match every slot to a real spool before slicing | A mistake in the mapping is a mistake on the print; the wrong slot wastes the whole part. |
| Height range modifier | Applies a different filament to a band of layers | Start the band on the exact layer the new color should begin | The band is defined in absolute height, so a change in layer thickness moves its edges. |
| Flush volume and purge amount | How much material is pushed through to clear the previous color | Increase it when the new color starts muddy or streaked | More flush means more waste and a longer print, and it will not fix a partly clogged nozzle. |
| Prime tower | A sacrificial tower where the nozzle primes after a switch | Keep it on for multi-material work | Shrinking or moving the tower can leave the nozzle under-primed exactly at the switch. |
| Wipe into infill and flush into object | Sends purge material into the part instead of the tower | Only where the inside of the part can absorb it | Purged material is not the part's own color; keep it away from visible or thin-walled surfaces. |
| Variable layer height | Changes the layer thickness through the part | Set it before you place a layer-based color change | Adding it afterwards renumbers the layers and shifts the whole change. |
| Preview layer slider | Shows exactly what prints at each layer | Scroll to the change layer and watch the color flip | A boundary that looks right in the object view can still be one layer off in the preview. |
The chart gives direction, not universal numbers. Flush volume, purge amount, and the exact filament-change command depend on your printer, firmware, and material, and your printer and filament profiles already ship with starting values. Keep those as your baseline and change one control at a time.
Ordered Sequence
Work top to bottom. Slice and check the preview before you commit a long print, and re-test small after any change.
Decide the method before you slice.
A single extruder means a pause or a filament change at a layer. A multi-material system means a tool change. The two are configured in different places, and switching later means slicing again.
Load and map the second color.
Put the spool in the machine, load it, and make sure the slicer's filament list matches what is physically loaded and which slot it is in. A color change can only use a filament that exists.
Find the layer in the preview.
Use the layer slider to find the first layer that should be the new color. Note the layer or its height, not the name of a feature; the boundary is a Z value.
Insert the change on that exact layer.
Add the color change, or the pause, on that layer. If your build offers both, pick the one that matches whether the machine switches filament itself or stops and waits for you.
Set the flush or purge for the transition.
Give the swap enough purge that the previous color is cleared before the new one starts. If the profile ships a value and the first test still looks muddy, step it up rather than jumping.
Verify the boundary in the preview.
Scroll through the layers around the change and watch the color flip. This is the cheapest place to catch a change that is one layer off.
Print a small test first.
Run a short part through the same change before committing a long print. A short test tells you whether the pause, the swap, and the purge actually work on this machine.
Be at the machine for a manual swap.
If the printer is waiting for you, be there when it stops. Wait until it has actually paused and parked, and keep your hands clear of the gantry, the bed, and the hot end.
Check the joint at the color boundary.
Flex or load the test part at the seam and look for a weak line. If the part is functional, test it before you trust it.
Record what worked.
Write down the layer, the filament slot, the flush value, and the result in your own notes or the profile description. Color changes are machine- and material-specific, and a saved note beats memory on the next spool.
Common Mistakes
These are the moves that put the color in the wrong place, or leave a visible seam where it should not be.
Picking a layer by model feature instead of by height.
The change lands on a Z value. A feature that spans several layers, a top surface, or a hole that opens there will change color partway through.
Forgetting to load the second filament.
The slicer writes a command; it cannot create a spool. An empty or unmapped slot means the swap fails in the middle of the print.
Running a color change on a machine that cannot pause cleanly.
Some firmware and some networked setups do not handle a mid-print stop reliably. Test the pause on a small part before trusting it on a long one.
Too little purge at the switch.
The first layers of the new color come out muddy or streaked. Increase the flush rather than accepting a blurred boundary.
Changing layer height after placing the change.
Variable layer height or a different layer thickness renumbers every layer, so the color lands somewhere other than where you put it.
Leaving the print paused far longer than planned.
A machine sitting hot with a part on the plate can warp the part and mark it. Do not start a manual swap you cannot finish.
Assuming a color change is also a material change you can trust.
If the second spool is a different material, the joint between the two materials is the weak point. Test the seam before the part is used for anything structural.
Reaching into a machine that is still moving.
Wait for the pause to complete and the axes to park. Keep hands clear of the gantry, the bed, and the nozzle, and let the hot end cool before you touch anything near it.
Edge Cases & Safety
Some color-change problems are not slicer problems. Check these before you spend another spool on tuning.
Enclosed printers and hard-to-reach nozzles
If the nozzle sits behind a panel, or the part is already tall when the change arrives, a manual swap is awkward and risky. Use a multi-material system if you have one, or place the change at a lower layer where you have real room. Never work around a guard or reach past a panel.
Paused jobs on shared or networked printers
A paused job on a machine other people can reach, or one driven over a network, can be resumed or cancelled by someone else. Coordinate before you leave a machine sitting paused.
Soluble and dedicated support materials
A multi-material setup can also run a soluble or dedicated interface material such as PVA or BVOH. That is a different job from a color change: it needs its own profile, genuinely dry storage, and a machine that truly supports multi-material printing.
Tall, thin, or top-heavy parts
A pause lets the part and the plate cool, and the nozzle can bump the part when the print resumes. On tall or unstable geometry, place the change lower or reorient the part instead of assuming the pause is harmless.
Changes placed in the last layers
A change near the top runs with the part at full height, which is where collisions and cooling effects are most likely. Read the preview at that height rather than assuming the top of the part is the easy place to swap.
Firmware and machine limits
Never exceed the nozzle temperature range printed on the spool or the maximum your hotend and heatbreak are rated for, and follow the filament-change procedure your printer manufacturer documents. If those disagree, stop, follow the lower limit, and check the printer's manual.
When to stop and ask
If the machine errors during the swap, if the part is a load-bearing or safety-relevant component, or if you are unsure about a temperature or firmware limit, stop. Consult the printer manufacturer's manual, the filament manufacturer's data sheet, or a qualified professional. Do not modify a machine on the strength of a forum post.
Food, skin, and children
A multi-colored print is not automatically food-safe, and a mid-print swap leaves a boundary inside the part where residue can sit. Do not use a printed part for food contact without verifying the material and the process for that use, and keep small offcuts and purge waste away from children and pets.
Purge waste and workspace
Flush and prime material is waste, not part of the print. Keep it off the plate and out of the machine's moving parts, ventilate the room when printing engineering materials, and keep cutters and deburring tools sheathed when they are not in use.
Frequently Asked Questions
How do I add a color change at a specific layer in OrcaSlicer?
Does a color change at a layer work on a single-extruder printer?
Why does my new color look muddy after the change?
Can I move the color change later without re-slicing?
Why did my color change land on the wrong layer?
Can I change material as well as color at that layer?
Keep going
If the boundary still lands a layer off, or the machine does not stop where you told it to, the cause is usually the filament-change command in your printer profile or the layer-height settings rather than the color change itself.