Civil 3D Warnings Explained
CutOnce 3.0 knowledge baseCivil 3D Warnings ExplainedUpdated October 2026

Why did Civil 3D warn you?

Every CutOnce warning has a Learn more link that opens the article for that exact situation. Each article shows the message you saw, what it means, why it matters downstream, and the better move. You still make the call: Continue, Stop, or Undo.

GUARD

Catch it before it breaks

Data-loss moves, change impact and plot readiness, with a Stop button that cancels the command before anything changes.

LEARN

Learn in the moment

One sentence on why it matters, then a link to the article for that warning. Firms can point the links at their own standards.

INSIGHTS

See the trend

Model health logged on every open, save and plot check, so teams see patterns across drawings, projects and people.

Start here

How CutOnce works

CutOnce sits inside Civil 3D and speaks up only when a move puts the model at risk. These three articles explain the model, the buttons and the settings behind every warning.

What’s new in CutOnce 3.0

3.0 adds a check before every plot and a cleaner, faster-to-read dialog. Your 2.2 configuration, project files and logs carry over unchanged.

How Civil 3D objects stay connected

Design integrityShown by: change-impact warnings not covered by a specific articleEvent: IMPACTLearn More topic: GENERAL

Civil 3D is a dynamic model. A surface feeds a profile, the profile and alignment drive a corridor, the corridor builds sections, quantities and sheets. Data shortcuts carry those objects into other drawings. Edit one link and everything downstream rebuilds from it, often without you seeing the change.

CutOnceHealthy Civil 3D models, one save at a timev3.0
!WARNING · AECCEDITSOMETHING

4 objects depend on Alignment “CL Main St”

They are built from what you are about to edit and will change with it. Some may break.

  • Profiles: EG, FG
  • Corridors: Main St
  • Sample line groups: SL-Main
Learn moreContinueStop command
Example change-impact warning

What the impact warning lists

  • Profiles and profile views built on an alignment.
  • Corridors that use the alignment, profile or surface as a target.
  • Sample line groups and view frames that will shift with the alignment.
  • Grading groups that reference a surface (on releases whose API exposes them).
  • Pipe parts nearby, found by bounding box, so treat them as “worth checking”.

The habit to build

Before you edit an alignment, profile or surface, ask what is built on it. If the list surprises you, stop and check with whoever owns those objects. Your firm’s CAD manager can add extra commands to this warning (see Control Center).

Stop, Undo or keep going

All warningsSwitches: WarnOfferStop, WarnWhileSelectingEvents: COMMAND-STOPPED, COMMAND-UNDONE, SELECTION-FILTERED

CutOnce never blocks you without a choice. Each warning ends with a decision on the right: Continue first, the red Stop last. Enter or ESC always means Continue, so muscle memory never cancels a command by accident.

When the warning showsYour buttonsWhat happens
Before the command changes anything (impact with objects selected first, grip and surface edits, EXPLODE with objects selected first, REFEDIT, REFCLOSE, promote, TEXT tips)Stop command, ContinueStop cancels the command before it touches the drawing. Nothing changes.
MOVE, STRETCH, ROTATE or SCALE started with nothing selected, as you pick a Civil 3D object with dependentsMove it anyway, Deselect it, keep going, Stop MOVEKeep it, drop just that object from the selection and carry on, or cancel the whole command.
After the command ran (EXPLODE or BURST picked inside the command, xref bind, xref moved or copied)Undo command, ContinueUndo is the same as typing U.
Before a plot 3.0Plot anyway, Rebuild and continue, Stop PLOTSee Check before you plot.
After cleanupUndo cleanup, Close, Save nowUndo reverses the whole cleanup in one step.
Every Stop and Undo is logged, so CAD managers can see which warnings actually change what designers do. That is the evidence that the guardrails are working.

The CutOnce Control Center

SettingsOpen with: CUTONCE (or -CUTONCE at the command line)Learn More topic: CONTROL_CENTER

One window to switch every check, warning and log on or off for yourself. Choices save to your AutoCAD profile and apply to every open drawing at once. Turning a master switch off greys out the switches under it. A lock icon means your CAD administrator set that value for everyone.

CardWhat you control
Command warningsMaster switch; every time or once per command per session; one switch per command (MOVE, COPY, STRETCH, ROTATE, SCALE, EXPLODE, XREF bind, REFEDIT, promote, TEXT, DTEXT, MTEXT, grips, surface edits, other watched commands); Stopping a command (Offer Stop / Undo, Warn while selecting)
Before plotting 3.0Master switch; out-of-date corridors and surfaces; xrefs not loaded; overridden labels; Check this drawing now
Checks on saveUnusual growth; offer cleanup; backup before cleanup; backup folder with Open
Standards check when a drawing opensRun on open; ByLayer; xref status; xref at 0,0,0; coordinate system and units; labels with overridden text; always show; include block definitions
LoggingMaster switch; Health.csv on save and on open; Xrefs.csv; Events.csv; Opened.csv; log folder with Open
ColorsNormal, Light or Dark for every CutOnce window. The Control Center previews the change as you click.

Good to know

  • Reset to defaults returns every switch to your firm’s defaults.
  • Once per session hides repeat warnings, but Events.csv still records every one. Overridden labels are called out on every plot regardless.
  • How to add other watched commands… walks CAD administrators through adding a command to the change-impact warning.
  • For scripts and toolbar buttons: ^C^C-CUTONCE;WarnEXPLODE;; toggles one setting.
Before you plot · new in 3.0

Plot what the model says

A sheet is a promise about the design. These checks run as PLOT, -PLOT, PUBLISH, -PUBLISH, EXPORTPDF, EXPORTDWF and EXPORTDWFX start, so stale data never leaves the office. When nothing needs attention, the plot just runs.

Check before you plot

Plot readinessTrigger: PLOT, PUBLISH, EXPORTPDF and the other plot commandsSwitches: GuardPlot, PlotOutOfDate, PlotXrefs, PlotLabelOverridesEvent: PLOT-GATELearn More topic: PLOT_GATE

The message

CutOnceHealthy Civil 3D models, one save at a timev3.0
!PLOT CHECK · PLOT

3 objects are out of date. This plot would show old data.

C-Roadway.dwg · Layout: PP-01

2Corridors out of date1Surfaces out of date1Xrefs unloaded4Labels with overridden text

Type CUTONCE-LABELS to select the labels with overridden text.

Learn morePlot anywayRebuild and continueStop PLOT
Plot check warning

What it checks

  • Out-of-date corridors and surfaces. The sheet would print geometry, grades and labels from before the last change. See Out-of-date corridors and surfaces.
  • Xrefs unloaded or not found. Base files, utilities or survey would simply be missing from the sheet, and nothing on paper tells the reader.
  • Civil 3D labels with overridden text. The label shows what someone typed, not what the model says. See Labels with overridden text.

Your choices

  • Plot anyway (Enter): plot as is. Good for a quick check print.
  • Rebuild and continue: shown when something is out of date. Rebuilds everything, then starts the plot again.
  • Stop PLOT: cancel and fix first.

Good to know

  • PUBLISH checks the active drawing only, not the other drawings in the sheet list. Open them, or run CUTONCE-PLOTCHECK in each.
  • Labels are read in Model Space and the current layout. On very large drawings the label check stops after about half a second to keep plotting fast, and the count reads “at least”.
  • Batch and scripted plots never wait on a click. A plot from a script, AutoLISP, another application, the console, or with FILEDIA at 0 shows no dialog. The result is still logged.
  • CUTONCE-PLOTCHECK runs the same check without plotting, lists every check, and offers Rebuild all. When everything passes it reads “Ready to plot. Nothing needs attention.”

Out-of-date corridors and surfaces

Plot readinessShown by: plot check, and the rebuild progress windowSwitch: PlotOutOfDateEvent: PLOT-GATELearn More topic: PLOT_OUT_OF_DATE

The message

CutOnceHealthy Civil 3D models, one save at a timev3.0
iREBUILD

Rebuilding 3 out-of-date objects.

  • Corridor: Main St
  • Corridor: Oak Ave
  • Surface: FG-Main
Learn more
Rebuild progress

What it means

Civil 3D flags a corridor or surface as out of date when something it is built from has changed (an alignment, a profile, a target, a breakline, a data shortcut) and the object has not rebuilt yet. Until it does, what you see and plot is the previous design.

Why it matters

  • Sheets disagree with the model. Sections, grades, daylight lines and quantities print from old geometry.
  • Errors travel. A stale sheet in a submittal becomes a review comment, an RFI, or a field change.
  • Downstream surfaces lag too. A corridor surface built from an out-of-date corridor is also wrong.

Do this instead

  • Choose Rebuild and continue. CutOnce stops the plot, rebuilds every out-of-date corridor and surface in one go with a progress bar and checklist, then starts the plot again.
  • Or run CUTONCE-PLOTCHECK and click Rebuild all before you start a plot set.
  • Rebuild before every issued set as a habit, even when Rebuild Automatic is on for small objects.

Good to know

  • The rebuild cannot be cancelled half way, because each step changes the drawing.
  • Settings typed at a -PLOT prompt are not replayed after the rebuild. The command starts fresh.
  • This check uses IsOutOfDate, available in the Civil 3D 2024 to 2027 API. On a release without it, the dialog says “Out-of-date check skipped”. The xref and label checks still run.

Labels with overridden text

Design integrityShown by: standards check (“Overridden labels” link) and plot checkSwitches: StdLabelOverrides, PlotLabelOverridesSelect them: CUTONCE-LABELSLearn More topic: STD_LABEL_OVERRIDES

The message

In the standards check: “Overridden labels show text someone typed, not live values: they stop updating when the design changes.” In the plot check: “4 labels have overridden text. This plot may not match the design.”

What it means

Someone used Edit Label Text on a spot, slope, station offset, pipe, structure, parcel, note or segment label. CutOnce sorts them two ways:

  • Edited: the override still contains live fields such as <[Station Value]>. It updates, but the wording no longer follows the label style.
  • Typed over: plain typed text. It never updates when the alignment, profile or surface changes.

Why it matters

  • The sheet stops telling the truth. A typed-over elevation looks right until the grade changes.
  • QA/QC cannot catch it. The label looks like every other label.
  • Standards drift. Edited text sidesteps the label style the firm maintains.

Do this instead

  • Type CUTONCE-LABELS to select every overridden label in the current space, or only the typed-over ones.
  • Open Edit Label Text and restore the live values. If the style does not say what you need, ask for a new label style instead of typing over.
  • Overridden labels are called out on every plot until they are fixed, even with warnings set to once per session.

Label groups (an alignment’s station ticks, for example) have no per-label overrides and are not counted. Health.csv records LabelsOverridden and LabelsTypedOver for every drawing.

Change impact

Know what moves when you move it

These warnings show what depends on the alignment, profile or surface you are about to edit. They appear as the command starts, with Stop, or as you pick objects for MOVE, STRETCH, ROTATE and SCALE.

Grip editing an alignment

Design integrityTrigger: grip edit with an alignment selectedSwitch: WarnGRIPSEvent: IMPACTLearn More topic: GRIP_ALIGNMENT
CutOnceHealthy Civil 3D models, one save at a timev3.0
!WARNING · GRIP EDIT

5 objects depend on Alignment “CL Main St”

They are built from what you are about to edit and will change with it. Some may break.

Learn moreContinueStop GRIP EDIT
Grip edit warning

Why it matters

  • Stationing shifts. Every station downstream of the edit moves, so callouts, sample lines and sheet match lines no longer line up.
  • Ground profiles resample. The existing-ground profile is recut along the new path; your design profile may now float or dig.
  • Superelevation needs recalculating. Curve changes invalidate attainment lengths and critical stations.

Do this instead

  • Use the Alignment Layout Tools or Geometry Editor to type exact radii, lengths and PI locations.
  • Check the listed profiles, corridors and sample lines right after the edit.
  • Rerun the superelevation calculation and review design checks.

Grip editing a profile

Design integrityTrigger: grip edit with a profile selectedSwitch: WarnGRIPSEvent: IMPACTLearn More topic: GRIP_PROFILE

The warning lists the corridors and profile views built on the profile you are dragging.

Why it matters

  • Grades and K values become arbitrary. A dragged PVI lands on whatever the cursor hits, not a design value.
  • Low points and clearances move. Drainage, cover and vertical clearance can fail without anyone noticing.
  • Corridors rebuild from it. Every section and quantity follows the drag.

Do this instead

  • Edit PVI station, elevation, grade and curve length in Profile Layout Tools or the Profile Grid View.
  • Run design checks for minimum K and grade, then review the listed corridors.

Manual surface edits

Design integrityTrigger: surface edit commands (Delete Line, Add Point, Swap Edge and others)Switch: WarnSURFACEEvent: IMPACTLearn More topic: SURFACE
CutOnceHealthy Civil 3D models, one save at a timev3.0
!WARNING · MANUAL SURFACE EDITS

3 objects depend on Surface “EG”

Manual surface edits (like Delete Line or Add Point) force a permanent deviation from the source design data. Where possible, change the source data instead.

Learn moreContinueStop command
Surface edit warning

What it means

Civil 3D rebuilds a surface from its definition, in order. A manual edit is stored as an operation at a location. When new data is added above or below it in the list, the edit can shift, double up or disappear.

Do this instead

  • Fix the source: add a breakline, adjust a feature line, tighten a boundary, clean the point group.
  • If you must edit manually, note why in the surface description so the next person knows.
  • Check the listed profiles, corridors and volume surfaces afterwards.

Surface edits started from the Toolspace right-click menu do not raise a command event, so CutOnce cannot see them.

MOVE on Civil 3D objects

CoordinationTrigger: MOVE on alignments, profiles, surfaces and other Civil 3D objectsSwitches: WarnMOVE, WarnWhileSelectingEvents: IMPACT, SELECTION-FILTEREDLearn More topic: MOVE

The message, while you select

CutOnceHealthy Civil 3D models, one save at a timev3.0
!WARNING · MOVE

You just selected Alignment “CL Main St”

Nothing has changed yet. Choose whether to move it with everything else, take it out of the selection, or stop MOVE.

Learn moreMove it anywayDeselect it, keep goingStop MOVE
Warning while selecting

Why it matters

  • Design objects carry real-world coordinates. Moving them moves the design off its survey control.
  • Dependents follow. Profiles resample, corridors rebuild, and data shortcuts push the shift into every drawing that references them.
  • It hides coordinate problems. Moving the design to “fit” an xref masks the real issue, which is usually the xref.

Do this instead

  • Choose Deselect it, keep going to move the linework and leave the design object where it belongs.
  • If the base is off, fix the xref insertion or the coordinate system. See Xref not at 0,0,0.
  • Moving an xref has its own warning. See Moving or copying an xref.

STRETCH on Civil 3D objects

Design integrityTrigger: STRETCHSwitches: WarnSTRETCH, WarnWhileSelectingEvent: IMPACTLearn More topic: STRETCH

While you pick, the warning offers Stretch it anyway, Deselect it, keep going and Stop STRETCH.

Why it matters

  • Crossing windows distort geometry unevenly. Some vertices move and others stay, so tangents, curves and grades bend in ways no design rule produced.
  • Constraints break quietly. Fixed and floating entities lose tangency; profiles lose curve lengths.

Do this instead

  • Edit the object’s geometry with its layout tools, using typed values.
  • Deselect Civil 3D objects and stretch only the drafting linework.

ROTATE on Civil 3D objects

CoordinationTrigger: ROTATESwitches: WarnROTATE, WarnWhileSelectingEvent: IMPACTLearn More topic: ROTATE

While you pick, the warning offers Rotate it anyway, Deselect it, keep going and Stop ROTATE.

Why it matters

  • Bearings become false. Every bearing, direction label and legal description now disagrees with the survey.
  • Coordinates move. A rotation about any point other than the true origin shifts the whole design.

Do this instead

  • Rotate the view, not the model: use a rotated UCS with PLAN, or rotate the viewport with DVIEW or the view frame.
  • Leave design objects in true north and real coordinates.

SCALE on Civil 3D objects

Design integrityTrigger: SCALESwitches: WarnSCALE, WarnWhileSelectingEvent: IMPACTLearn More topic: SCALE

While you pick, the warning offers Scale it anyway, Deselect it, keep going and Stop SCALE.

Why it matters

  • Design values drift. Radii, lengths, grades and areas all change by the factor; stationing no longer matches the field.
  • It is usually a units problem in disguise. Scaling by 0.3048 or 1200/3937 fixes the look and breaks the data.

Do this instead

  • Fix drawing units and the coordinate system in Drawing Settings, then reinsert with the right insertion units.
  • For grid-to-ground, use the drawing’s scale factor settings, not SCALE.
  • For plotted size, use annotation scale.
Standards check on open

Start every session on a clean sheet

When a drawing opens, CutOnce checks it against the basics. It speaks up only when something is wrong, unless you chose “always show”. Type CUTONCE-CHECK to run it any time.

Reading the standards check

AdvisoryTrigger: drawing opens, or CUTONCE-CHECKSwitch: StdCheckOnOpenEvent: STANDARDS-OPENLearn More topic: STANDARDS_OPEN
CutOnceHealthy Civil 3D models, one save at a timev3.0
!WARNING · STANDARDS CHECK

C-Grading.dwg: 4 standards issues to fix

Fixing these before the drawing goes out avoids broken references, stale labels and mismatched coordinates downstream.

38Objects not ByLayer1Unloaded xrefs1Xrefs off 0,0,06Labels overridden
How to read thisAbout ByLayerXrefs off 0,0,0Overridden labelsShow detailsOK
Standards check

How to read it

Number tiles show only what needs attention. Show details opens the full report: objects not ByLayer (Model Space, layouts, and block definitions), xrefs with their status and insertion point, the coordinate system and insertion units against the project standard, and overridden labels. Each tile type has its own Learn more link below.

Fix in this order

  1. Coordinate system and units. Everything else sits on top of them.
  2. Broken or unloaded xrefs. You cannot judge what you cannot see.
  3. Xrefs off 0,0,0. Shared coordinates first, then drafting.
  4. Overridden labels. Restore live values before anything is issued.
  5. Objects not ByLayer. Last, because it is cosmetic until you plot or screen.

When everything passes: “Nothing to fix: ByLayer, xrefs, coordinates, units and labels all check out.”

Objects not ByLayer

AdvisoryLink in dialog: “About ByLayer”Switches: StdByLayer, StdScanBlocksLearn More topic: STD_BYLAYER

Why it matters

  • Plotting breaks. Hard-coded colors ignore the firm’s plot styles and pen weights.
  • Layer control stops working. Freezing or recoloring a layer leaves the overrides behind.
  • Background screening fails. When the drawing becomes someone else’s xref, your objects will not screen with the rest.

Do this instead

  • Select the objects with Quick Select or SETBYLAYER and set color and linetype to ByLayer.
  • Inside block definitions, edit the block and set its objects ByBlock or ByLayer.
  • Need a different look? Use a different layer or style, not an override.

Xrefs broken or unloaded

CoordinationLink in dialog: “Broken xrefs”Switches: StdXrefStatus, PlotXrefsLearn More topic: STD_XREF_STATUS

Why it matters

  • You design blind. Utilities, right of way or survey that should be on screen are not.
  • Sheets go out incomplete. Since 3.0 the plot check also flags unloaded and missing xrefs before you plot.
  • Paths rot. Absolute paths break when projects move between servers or are shared with others.

Do this instead

  • Open External References, repath broken xrefs with relative paths, and reload.
  • If an xref is unloaded on purpose, unload it in a working copy or detach it before issuing.

Xref not inserted at 0,0,0

CoordinationLink in dialog: “Xrefs off 0,0,0”Switch: StdXrefOriginLearn More topic: STD_XREF_ORIGIN

Why it matters

  • Hidden offsets. The base looks right on screen but every coordinate in it is wrong by the insertion offset.
  • Coordination errors multiply. Each discipline that “fixes” it by moving their own work adds another offset.

Do this instead

  • Reattach the xref at 0,0,0, rotation 0, scale 1.
  • If it still does not line up, the source drawing is in a different coordinate system or units. Fix the source.

Coordinate system and units

CoordinationLink in dialog: “Coordinates & units”Switch: StdCoordUnitsLearn More topic: STD_COORD_UNITS

What it flags

  • No coordinate system assigned (unless your firm turned that off for details and sheets).
  • A coordinate system that differs from the project or from a loaded xref.
  • Insertion units set to Unitless, or different from the project or an xref.

Why it matters

  • Feet and US Survey Feet are not the same. The difference is about 2 parts per million: small on a lot, several feet across a state plane zone.
  • Geolocation, imagery and GIS exchange depend on it. Without a coordinate system, nothing outside Civil 3D knows where the design is.

Do this instead

  • Set the zone in Drawing Settings, Units and Zone, and match the project.
  • Ask your CAD manager to add a CutOnce-Project.ini to the project’s top folder so every drawing is checked against the right system and units.
Guard

Moves you cannot take back

These commands throw away design data or push changes into shared files. CutOnce warns before they run when it can, with Stop, and right after they run when it cannot, with Undo.

Exploding Civil 3D objects, blocks or hatches

Data lossTrigger: EXPLODE, BURSTSwitch: WarnEXPLODEEvent: EXPLODE-LOSSLearn More topic: GUARD_EXPLODE

The message

CutOnceHealthy Civil 3D models, one save at a timev3.0
!HIGH RISK · EXPLODE

EXPLODE will flatten 3 selected objects

Civil 3D objects become plain geometry and lose their labels, styles and design data. Anything built on them breaks.

Learn moreAbout attributesContinueStop EXPLODE
EXPLODE warning

Objects picked after EXPLODE started are reported right after it ran, with Undo EXPLODE: “They are plain geometry now: their design data, labels and anything built on them are gone. Undo brings them back.”

Why it matters

  • Civil 3D objects lose design intent. An exploded alignment, corridor or pipe network cannot be rebuilt from its pieces.
  • Blocks and hatches lose their data. An exploded hatch becomes many separate lines: it loses its boundary association and area, can no longer be edited as a pattern, and adds to file size.
  • Downstream objects break. Profiles, labels, data shortcuts and quantities that relied on the object stop working.

Do this instead

  • Delivering to someone without Civil 3D? Use Export to AutoCAD (EXPORTTOAUTOCAD) on a copy, not EXPLODE in the design file.
  • Need to change the look? Change the style, not the object.
  • Already done it? Click Undo EXPLODE or type U.

Exploding or bursting attributed blocks

Data lossTrigger: EXPLODE, BURST on blocks with attributesLink in dialog: “About attributes”Event: ATTRIB-LOSSLearn More topic: GUARD_ATTRIB

“Attribute data used for tags, schedules and data extraction is gone; only the displayed text remains.”

Why it matters

  • Schedules and data extraction break. Structure tables, title block fields and asset tags read attributes, not text.
  • BURST keeps the look, not the data. The values stay visible as plain text and can no longer be edited or reported.

Do this instead

  • Edit attributes with EATTEDIT or the Properties palette.
  • Redefine the block if its geometry is wrong.
  • Undo right away if it was a mistake.

Binding an xref

Data lossTrigger: XREF > Bind, XBINDSwitch: WarnXREFBINDEvent: XREF-BINDLearn More topic: GUARD_XREF_BIND
CutOnceHealthy Civil 3D models, one save at a timev3.0
!HIGH RISK · XREF BIND

Xref “C-Base” was bound into this drawing

Their layers, styles and blocks are now copied in for good, which often duplicates styles and grows the file. Attach or Overlay keeps a reference live.

Learn moreContinueUndo XREF
Xref bind warning

Why it matters

  • The link is gone. Updates to the source never reach this drawing again.
  • Standards break. Bound layers arrive renamed with prefixes and duplicate the firm’s styles.
  • Files bloat. Registered apps, styles and blocks pile up. Expect a growth warning at the next save.

Do this instead

  • Keep the xref attached or overlaid while design is active.
  • Bind only for a formal archive or transmittal, on a copy.
  • Detaching an xref is not a bind and is not reported.

Moving or copying an xref

CoordinationTrigger: MOVE or COPY on an xrefSwitches: WarnMOVE, WarnCOPYEvent: XREF-MOVEDLearn More topic: GUARD_XREF_MOVED
CutOnceHealthy Civil 3D models, one save at a timev3.0
!WARNING · MOVE

An xref moved off its insertion point

Everything in it now sits out of line with shared coordinates and data shortcuts.

Learn moreContinueUndo MOVE
Xref moved warning

Why it matters

  • The base leaves shared coordinates. Your design now lines up with a base that is in the wrong place.
  • A copied xref is two references. One is in the wrong place and both plot.

Do this instead

  • Undo, then fix the source drawing or its coordinate system so it overlays at 0,0,0.
  • To show part of a base elsewhere on a sheet, use a viewport, not a moved copy.

Editing an xref in place

CoordinationTrigger: REFEDIT, REFCLOSESwitch: WarnREFEDITEvents: ADVISORY-REFEDIT, ADVISORY-REFCLOSELearn More topic: GUARD_REFEDIT
CutOnceHealthy Civil 3D models, one save at a timev3.0
!WARNING · REFEDIT

You are about to edit a reference in place

Saving this edit changes the referenced drawing for everyone who uses it. Only save back if that is the plan.

Learn moreContinueStop REFEDIT
REFEDIT warning

Why it matters

  • You may not own the file. The xref often belongs to another discipline, office or consultant.
  • The change is quiet. Nobody using that file is told it changed.
  • Civil 3D objects do not belong here. REFEDIT works on AutoCAD geometry; design objects should be edited in their source drawing.

Do this instead

  • Open the source drawing, make the change there, and tell the people who use it.
  • Only looking? Use the xref’s layers or a viewport, not REFEDIT.

When you close the edit (REFCLOSE)

Event: ADVISORY-REFCLOSELearn More topic: GUARD_REFCLOSE
CutOnceHealthy Civil 3D models, one save at a timev3.0
!WARNING · REFCLOSE

Closing the in-place reference edit

Save writes your changes into the external drawing for everyone. Choose Discard if you were only looking.

Learn moreContinueStop REFCLOSE
REFCLOSE warning

Pick Discard unless saving back to the shared file is the plan, and you have told its owner.

Promoting a data reference

Data lossTrigger: any *PROMOTE* commandSwitch: WarnPROMOTEEvent: ADVISORY-PROMOTELearn More topic: GUARD_PROMOTE
CutOnceHealthy Civil 3D models, one save at a timev3.0
!WARNING · DATA SHORTCUT

Promoting a data shortcut breaks its link

You get an independent copy in this drawing; later changes to the source will no longer reach it.

Learn moreContinueStop PROMOTE
Promote warning

Why it matters

  • Two versions of the truth. The source keeps changing; your copy does not.
  • Nobody can tell from the sheet. A promoted alignment looks exactly like a referenced one.

Do this instead

  • Keep the reference and ask the source owner for the change.
  • If you are taking over ownership, agree it with the team and retire the old source so only one exists.

TEXT or MTEXT instead of Civil 3D labels

AdvisoryTrigger: TEXT, DTEXT, MTEXTSwitches: WarnTEXT, WarnDTEXT, WarnMTEXTEvents: TEXT-TIP, TEXT-USEDLearn More topic: GUARD_TEXT
CutOnceHealthy Civil 3D models, one save at a timev3.0
iINFO · MTEXT

Tip: a Civil 3D label may do this better

Plain text does not update when the design changes and is not picked up by schedules or QA/QC. A label stays live and on standard.

Learn moreContinueStop MTEXT
Text tip

Do this instead

  • Station, offset, elevation, grade, pipe size and parcel area all have label styles. Add Labels from the Annotate tab.
  • For general notes, plain MTEXT is fine. Continue.

Unusual growth since the last check

File healthTrigger: saveSwitches: GuardGrowth, GuardCleanupEvent: SAVE-FLAGLearn More topic: GUARD_GROWTH
CutOnceHealthy Civil 3D models, one save at a timev3.0
!WARNING · SAVE CHECK

C-Grading.dwg grew unusually since its last check

Unused items make saves and opens slower. Clean up removes them once this save finishes; Save a copy keeps today’s version first.

  • RegApps: 12 -> 48 (new registered app(s), often left by a bind or a foreign block)
  • Layers: 140 -> 190 (up 36% since the last check)
Learn moreSave a copyClean up now…Continue
Growth warning

What it means

CutOnce compares this save with the last check of the same drawing in your Health.csv. Any count up by the firm’s threshold (20% by default) or new since the last check is flagged. Big jumps in registered apps, styles, anonymous blocks or layers usually come from pasted content, bound xrefs, or blocks from other firms.

Do this instead

  • Click Clean up now… to purge after the save. See Cleaning up a bloated drawing.
  • Paste from other drawings with care; insert blocks from your firm’s library.

After upgrading to 3.0, the first save may flag Styles growth once. Style counts now come from the Civil 3D style collections, so the baseline resets.

Cleanup and backups

Clean up without the risk

Cleanup is offered by the growth warning and by CUTONCE-CLEANUP. A backup copy comes first, and one Undo reverses it all.

Cleaning up a bloated drawing

File healthTrigger: Clean up now… or CUTONCE-CLEANUPEvent: CLEANUPLearn More topic: GUARD_CLEANUP

The steps, in order

  1. Unused Civil 3D styles (Purge Styles, runs first)
  2. Unused text, dimension, leader, table and multiline styles
  3. Unused registered applications (RegApps)
  4. Unused anonymous blocks
  5. Everything else unused: layers, linetypes, blocks (PURGE All)
  6. Reset the annotation scale list
  7. AUDIT and fix errors (runs last)
CutOnceHealthy Civil 3D models, one save at a timev3.0
✓ALL CLEAR · CLEANUP

Cleanup finished. 214 unused items removed.

Undo reverses all of it. Save the drawing to keep the result.

  • Backup copy saved
  • Civil 3D styles: 61 removed
  • Registered apps: 36 removed
  • Layers, linetypes, blocks: 117 removed
Undo cleanupLearn moreCloseSave now
Cleanup result

Good to know

  • PURGE only removes items nothing uses. An unchanged count means everything of that kind is still in use.
  • Each step’s messages are on the command line (F2).
  • The whole cleanup is one undo step. Undo cleanup is the same as typing U.
  • If your CAD administrator requires a backup and the copy fails, cleanup stops and nothing changes.
  • Cleanup is not offered while a drawing is closing. If it does not start after the save, type CUTONCE-CLEANUP.

Backup copies and Save a copy

Safety netTrigger: Save a copy, cleanup, CUTONCE-BACKUPSwitch: BackupBeforeCleanupEvent: BACKUP-COPYLearn More topic: BACKUP

Save a copy appears on the growth warning and on warnings for risky edits. It copies the drawing to the firm’s backup folder before you go ahead. CUTONCE-BACKUP makes a copy any time; CUTONCE-BACKUP-FOLDER opens the folder.

  • What is copied: the drawing as last saved, so a copy made from a warning never includes the change being warned about. With unsaved changes, CUTONCE-BACKUP asks whether to save first.
  • Names never collide: C-Grading__20261015-143005-789_jsmith-CAD-PC12.dwg, down to the millisecond, plus user and computer.
  • Every copy is recorded in Backups.csv, even with logging off.
  • Where: your firm’s shared backup folder, or Documents\CutOnce Backups if none is set. CutOnce never deletes copies.
For CAD managers

Make the guardrails your own

Every Learn more link, color, switch and lock is set in CutOnce-Config.lsp. Point links at your firm’s videos and standards, set firm defaults, and lock what must not change. The full setup is in the CAD Admin Guide shipped with CutOnce.

Event codes in Events.csv

ReferenceSwitch: LogEvents

Events.csv gets one row per warning, including warnings hidden by once-per-session. Columns: who, when, drawing, event type, detail.

CodeWritten when
PLOT-GATE 3.0Every plot check, with or without a dialog. Detail reads like PUBLISH: out of date 2, xrefs not loaded 1 (140 ms); stopped. Endings: clear, continued, stopped, rebuild and continue, dialog already shown this session, or no dialog (FILEDIA is 0) and the other automation reasons (script, AutoLISP, another application, batch or console).
COMMAND-STOPPEDA designer clicked Stop.
COMMAND-UNDONEA designer clicked Undo, including Undo cleanup.
SELECTION-FILTEREDA designer chose Deselect it, keep going.
IMPACTChange-impact warning.
STANDARDS-OPENStandards check on open found something.
EXPLODE-LOSS, ATTRIB-LOSSEXPLODE or BURST on Civil 3D objects, blocks, hatches, attributes.
XREF-BIND, XREF-MOVEDXref bound, or moved or copied off its insertion point.
ADVISORY-REFEDIT, ADVISORY-REFCLOSE, ADVISORY-PROMOTEREFEDIT, REFCLOSE, promote started.
TEXT-TIP, TEXT-USEDLabel tip shown; plain text placed.
SAVE-FLAG, CLEANUP, BACKUP-COPYGrowth flagged; cleanup ran; backup copy made.

The ratio of COMMAND-STOPPED to warnings shown is the clearest measure of whether the guardrails change behavior. Combine every person’s logs in Excel with Data > Get Data > From Folder.

Branding and color modes

ReferenceSettings: BrandName, BrandTagline, BrandColor, BrandLogo, ColorModePreview: CUTONCE-PREVIEW

Every 3.0 window shares one frame, built so a warning reads in five seconds:

  1. Header: your logo tile, name and tagline, a version pill, over a thin line in your brand color.
  2. Severity: a color strip down the left and a round icon. ! for WARNING and HIGH RISK, a check for ALL CLEAR, i for INFO.
  3. Headline says what is happening; one sentence says why it matters; number tiles or a short list show only what needs attention; anything longer waits behind Show details.
  4. Action bar: Learn more on the left; the decision on the right, Continue first and Stop in red last.

Designers pick Normal (graphite header, white body), Light or Dark in the Control Center. In Dark, severity and brand colors are brightened to stay readable. Set the firm default with ColorMode and lock it if every designer should match. Without a logo, the tile shows the CutOnce mark: a check above a dashed cut line. CUTONCE-PREVIEW shows a sample Explode, Plot or Rebuild window in your branding.

Command reference

Reference
CommandWhat it does
CUTONCE / -CUTONCEControl Center, or the same at the command line
CUTONCE-PLOTCHECK 3.0Run the plot check without plotting; lists every check, offers Rebuild all
CUTONCE-LABELSSelect labels with overridden text (all, or typed over only)
CUTONCE-CHECK / CUTONCE-CHECK-STATUSStandards check now; its settings
CUTONCE-CLEANUPCleanup dialog
CUTONCE-BACKUP / CUTONCE-BACKUP-FOLDERCopy this drawing to the backup folder; open the folder
CUTONCE-AUDIT / CUTONCE-AUDIT-FOLDERRecord every open drawing, or every .dwg in a folder, in Health.csv and open it in Excel
CUTONCE-STATUSVersion, folders, config file, logging, Stop on or off, plot check
CUTONCE-PREVIEWSample Explode, Plot or Rebuild window in your branding
CUTONCE-RELOADCONFIGRe-read CutOnce-Config.lsp without restarting
CUTONCE-GUARD-STATUS / -CHECKNOW / -SUMMARY / -LOGGuard switches, health check now, history rollup, log paths
CUTONCE-GUARD-DUMPOBJECTSCount every object type by name (for HealthExtraCounts)
CUTONCE-GUARD-LOGCOMMANDSEcho each command name as it runs (for ImpactExtraCommands and PlotGateCommands)
CUTONCE-IMPACT-ON / -OFF / -STATUS / -DEBUGCommand warnings on or off, status, diagnostics
Measure twice. CutOnce.CutOnce 3.0 for Civil 3D 2021 and later. Organization and per-user licenses, plus a free trial with the EXPLODE guard. designtovisualization.com

Questions or licensing: stevewalz@hotmail.com

CutOnce 3.0.0 · © 2026 Stephen Walz. Civil 3D and AutoCAD are trademarks of Autodesk, Inc. CutOnce is an independent product and is not affiliated with Autodesk.