When a Step Goes Red
A rebuild that fails announces itself in one way: the step that failed turns pastel red and pulses, and every other pill in the timeline turns gray. Find the red pill, click it, and read the banner at the top of its panel. That banner is the only place the message exists.
The message lives inside the step
There is no global error list and no summary anywhere in the editor. Nothing counts the failures, nothing lists them, and no toast appears. If you do not look at the timeline, you will not know.
The banner carries the message word for word, and the message is the whole diagnosis. There is no code to look up and no second screen with more detail. Warnings use the same banner in yellow, and a warning does not stop the rebuild.
Finding the right step first
When several pills are red, open the earliest one. Failures cascade: a fillet that lost its edge will take everything built on top of it with it, and fixing the first usually clears the rest. Work down the timeline, not up.
If a group's pill carries the error tint, the failure is inside it. Click the group to drill in, and the back arrow to come out.
And before anything else, consider undo. A step that was fine a minute ago failed because of the edit you just made, and Ctrl+Z is faster than diagnosis.
Family one: geometry refused
The step is asking for something the shape cannot give. The value is too big for the material available, or the elements you picked cannot be resolved together.
Fillet geometry failed — common causes: radius too large, edges interfere, edges not connectable, tangency problem. Try a smaller radius or fewer edges.
Shell geometry failed — common causes: thickness too large for local feature size, or selected faces leave the boundary disconnected. Try a smaller thickness or fewer faces.
Offset failed — the distance may be larger than a local feature of the part. Try a smaller distance.
These messages name their own causes and end with a suggestion. Take the suggestion literally and in order.
Halve the value first. If a 4 mm fillet fails, try 2 mm. If 2 mm works, the problem is size, and the fix is either a smaller radius or more material where it runs.
Then cut the selection down. If a small value still fails, the problem is the selection. Split the step into two, with half the edges in each, and you will find out in one rebuild which edge is the culprit.
Family two: an input that vanished
The step is looking for a face, an edge or a body that is no longer there.
A referenced face/edge/vertex no longer exists
This is what you get after deleting the step that produced the element, or after an edit that moved it far enough that it could not be re-found. Extrudes, fillets and booleans are deleted without any warning about their dependents, so this message often arrives one edit after the deletion that caused it.
Two fixes. If the element still exists in some form, open the failed step, clear the pick and pick it again. If the step that made it is gone, the element is gone too, and the failed step has to be re-pointed at something else or deleted.
The same family covers the case where the inputs still exist but no longer meet:
Intersection is empty (selected bodies do not overlap)
Here nothing is missing. A dimension changed and the two bodies moved apart. Roll back to see where they parted company.
References That Survive an Edit explains why a face that is obviously still on screen can still be reported as gone.
Family three: a value the step will not accept
The geometry is fine, but what you gave the step is outside what it can work with. These messages state the rule rather than suggesting a smaller number.
Profile region crosses the revolve axis — profile must lie on one side
Helical sweep does not support face-with-holes profiles in this release
The first is a rule of revolving: move the axis or the profile so they do not cross. The second is a limit of the release: build the outer profile as one sweep and subtract the holes afterwards.
A refusal of this kind will not clear by nudging the number. Read what it says the rule is and change the input to satisfy it.
Family four: an upstream step is disabled
A referenced feature is suppressed
Something this step depends on has been turned off. Right-click the disabled pill, the gray one with the cursor that refuses, and choose Enable.
If you disabled the step on purpose to find out what depended on it, this message is the answer you were looking for.
Warnings
A yellow banner does not stop anything. The one you will meet is on a step whose pick was matched by measurement rather than by identity: the model rebuilt, the fillet landed somewhere, and the app is telling you it is not certain that is where you meant. Look at what is highlighted before you carry on, because nothing downstream will complain and neither will the export.
Working through a failure
- Scan the timeline for the red pills and open the topmost one.
- Read the banner and decide which family it is: something refused, something missing, something disallowed, something switched off.
- If the message ends with a suggestion, follow it, and halve the value before anything else.
- If it names a missing reference, decide whether to re-pick or to re-point.
- Rebuild and look at the timeline again, not at the part. The part looks wrong in the same way whether one step is failing or five.
When you cannot clear it
Some steps cannot be recovered in place: the geometry they were built on has changed shape rather than moved. Delete the failed step and build it again on the part as it now stands.
A red step does not stop you saving or exporting
Neither is blocked, and neither warns you.
Saving is untouched. The document is the recipe, not the result, so a file with a failed step in it saves, closes and reopens like any other, and it comes back failing in the same place. Nothing is lost by leaving a red pill in a document overnight.
Export is the one to think about. A failed step produces no geometry at all, so whatever it would have made is missing from the file you download, silently. Nothing in the export dialog mentions the failure. A cut that failed leaves a part with no hole in it, and that part slices, prints and wastes an evening before you notice.
So look at the timeline before you export, not at the part.
See also
- Reading the Timeline: the gray-and-red display that is the only cue you get
- References That Survive an Edit: why a step loses a face that is still there
- Editing a Part You Have Built: the edits that cause most of these, and how to undo them
- Working with Several Bodies: deleting a feature and what it leaves broken