What Is an Xref and Why Use It
An xref is a drawing file linked into your current drawing — not copied, just referenced. Think of it like a live hyperlink to another DWG. When the source file changes, your drawing picks up the update the next time it's opened or reloaded. This is the foundation of collaborative multi-discipline CAD: the civil team owns the base map, the electrical team owns the pole layout, and your sheet draws from both without duplicating any geometry. Changes flow automatically. Nobody has to manually merge files.
Why Xref Instead of Paste
| Copy/Paste | Xref |
|---|
| Frozen in time at paste moment | Live — updates when source changes |
| Increases file size | Tiny addition — just a link |
| One copy per drawing | Same source, hundreds of drawings |
| Manual updates needed | Reload once, all references update |
| Can accidentally edit | Read-only in host drawing |
| Layers mixed in | Layers prefixed — always distinguishable |
Common Xref Use Cases
| Scenario | What's Xref'd |
|---|
| Utility pole layout sheets | Survey base, existing infrastructure, aerial view |
| Architectural project | Structural base, MEP coordination, civil site |
| Sheet-set production | Base plan into each discipline's sheet |
| Detail sheets | Standard detail library as overlay |
| As-built coordination | Record drawings overlaid on design |
| Multi-unit residential | Typical floor plan xref'd into site plan |
Attaching an Xref — Step by Step
1
Open the External References palette
Type XR (XREF alias) to open the palette. Or: Insert tab → Reference panel → Attach. The palette shows all currently attached xrefs with their status (Loaded, Not Found, Unloaded, Orphaned).
2
Click Attach DWG
Click the paper-clip icon or right-click in the palette → Attach DWG. Navigate to the source file. Choosing the right file is critical — confirm with the project team which file is the "live" reference, not a backup or archive copy.
3
Set Reference Type — Attach or Overlay
In the Attach External Reference dialog: choose Attach if this xref should appear when your drawing is itself referenced by others. Choose Overlay if it's local context you don't want to propagate up the chain (the safe default for most utility work).
4
Set Path Type
Choose Relative Path for any project where the files might move or be shared. Full Path works only if drive letters and folder structures are fixed. No Path works only for single-folder setups.
5
Set Insertion Point, Scale, Rotation
For most xrefs: 0,0,0 insertion, scale 1, rotation 0. Only adjust if the source drawing uses a different coordinate system or units. Check "Specify On-screen" if you want to pick the point manually.
6
Verify units match
If the xref was drawn in metric and your host is imperial (or vice versa), AutoCAD applies a conversion factor based on INSUNITS in both files. Check INSUNITS in both drawings and confirm geometry aligns correctly after attach. Use the ALIGN command to fix mismatched coordinate systems.
7
Manage Xref Layers
Xref layers appear prefixed: SURVEYBASE|WALLS. Freeze or change visibility of individual xref layers via the Layer Manager (LA). Use viewport layer overrides (freeze per viewport) to show different xref layers on different sheets. Never explode an xref — bind it first if permanent integration is needed.
Xref Workflow in Multi-Discipline Projects
🗺️
Survey / Base
Base DWG
📐
Design Team
XATTACH Base
📄
Discipline Sheets
XATTACH Design
🖨️
Plot / Publish
PUBLISH
Utility sheet strategy: Keep one survey base xref (Overlay type) in every discipline's drawing. Each discipline attaches only its own design content as Attach type. The sheet drawing then xrefs all discipline files. Overlay prevents the survey base from appearing multiple times in the final sheet.
Attach vs Overlay — Decision Guide
Use ATTACH when Carries through
- The xref content must appear in parent drawings
- Structural drawings referenced into a composite sheet
- Standard details that should follow the drawing everywhere
- The reference is integral to the sheet's content
- You're building a hierarchical xref chain intentionally
- Title blocks in sub-drawings (rare — usually in sheet)
Use OVERLAY when Stays local
- Base map / survey you reference for context only
- Adjacent building or lot shown for coordination
- Any xref already attached at a higher level
- Temporary reference geometry for construction
- You want to prevent circular xref warnings
- Default safe choice when you're not sure
Path Types — Detailed Breakdown
Full Path example
C:\Projects\Utility-2026\Survey\BASE-SURVEY.dwg
Breaks if: drive letter changes, folder renamed, file moved, shared via network with different mapping
Relative Path example (host is in \Sheets\)
C:\Projects\Utility-2026\Sheets\SHEET-E1.dwg references →
..\Survey\BASE-SURVEY.dwg
Survives: moving entire project folder, sharing via USB or cloud. Breaks if: only the sheet or only the xref moves independently.
No Path example
BASE-SURVEY.dwg
AutoCAD searches: same folder as host, then ACAD support paths (Options → Files). Use only for single-folder projects or standard library files.
Network / cloud projects: Use Relative Path. If using BIM 360 / ACC, use No Path or the cloud connector's path management — full paths will break on every team member's machine.
Xref Manager — Status Icons Explained
| Status | Icon | Meaning | Fix |
|---|
| Loaded | ✅ | Xref found and loaded correctly | No action needed |
| Not Found | ❌ | AutoCAD can't locate the file at the stored path | Right-click → Change Path, or move the file to the expected location |
| Unloaded | ○ | Deliberately detached from display (still in list) | Right-click → Reload to restore |
| Unreferenced | — | Attached but no instance placed in the drawing | Insert an instance or detach if not needed |
| Orphaned | ⚠️ | Parent xref is missing — this xref was nested in it | Fix the parent xref first; orphan resolves automatically |
| Circular | 🔄 | Drawing A xrefs B, B xrefs A — infinite loop | Change one xref to Overlay type, or restructure the xref chain |
Bind and Insert — Named Object Handling
| Named Object | Bind Result | Insert Result |
|---|
Layer XREF|WALLS | Renamed to XREF$0$WALLS | Renamed to WALLS (merged) |
Block XREF|COLUMN | Renamed to XREF$0$COLUMN | Renamed to COLUMN |
Textstyle XREF|ROMANS | Renamed to XREF$0$ROMANS | Renamed to ROMANS |
Dimstyle XREF|ARCH | Renamed to XREF$0$ARCH | Renamed to ARCH |
| Layer conflicts (same name both drawings) | Suffix increments: $0$, $1$, $2$… | Host drawing's version wins, xref's version discarded |
| Xref link | Broken — becomes a permanent block | Broken — content merged into host |
Be careful with Insert. If both your drawing and the xref have a layer called ELECTRICAL, Insert silently drops the xref's ELECTRICAL layer definition. Your electrical objects may change properties. Bind is safer — it always creates a new uniquely-named layer.
Xref Layer Management
Every layer inside an xref gets a prefix in the host drawing: XREFNAME|LAYERNAME. You can control visibility, color, linetype, and lineweight for these prefixed layers from the host's Layer Manager — but you cannot rename or delete them. Changes you make in the host are saved in the host drawing only; the source file is unchanged. Per-viewport overrides work the same way as for regular layers.
| Operation | Command / Method | Notes |
|---|
| Freeze all xref layers | LA → filter by xref name → select all → freeze | Fastest way to hide an entire xref without detaching |
| Freeze xref layer in one viewport only | Activate viewport → LA → VP Freeze column | Shows xref on some sheets but not others |
| Override xref layer color | LA → click color swatch for xref layer | Only affects host drawing; source unchanged |
| Lock xref layers | LA → lock icon for xref layers | Prevents accidental selection of xref objects |
| Save layer state with xrefs | LA → Layer State Manager → Save | Captures all layer visibility including xref layers |
| Restore after reload changes layers | Layer State Manager → Restore | Xref reloads can reset overrides; save state first |
In-Place Reference Editing (REFEDIT)
REFEDIT lets you edit an xref's content from within the host drawing — without opening the source file separately. Use it for small fixes; for major edits, open the source file directly.
1
Double-click the xref (or type REFEDIT) → select the xref → choose which nested objects to include in the working set.
2
Make your edits. Non-working-set objects fade (controlled by XDWGFADECTL). You can add, delete, or modify objects in the working set.
3
Save back — type REFCLOSE → Save Reference Edits. AutoCAD saves changes to the source DWG and reloads it. All other drawings referencing the same file will see the change on next reload.
REFEDIT risk: If multiple people have the source file open, your save will overwrite their in-memory version. Coordinate with the team before using REFEDIT on shared files. Consider opening the source file directly instead.
eTransmit — Packaging Drawings with Xrefs
When you send a drawing with xrefs to a client or print bureau, you must include all referenced files. ETRANSMIT packages everything automatically — the host drawing, all nested xrefs, fonts, plot styles, and images — into a ZIP or folder. It optionally converts all paths to relative or no-path before packaging.
1
Type ETRANSMIT → Create Transmittal dialog opens.
2
Set Transmittal Setup → choose "Bind xrefs" if the recipient doesn't need live xref links, or "Keep xrefs as-is" if they do. Set path type to "No path" for the package (all files in one folder).
3
Click OK → choose a location → AutoCAD creates the ZIP. Verify the transmittal report — any "Not Found" xrefs in the report won't be included.
System Variables Reference
Common Xref Problems & Fixes
| Problem | Likely Cause | Fix |
|---|
| Xref shows "Not Found" after moving project |
Full path stored; folder location changed |
XR palette → right-click xref → Change Path → locate file → OK → Reload All |
| Xref geometry is massive / tiny after attach |
INSUNITS mismatch (metric xref in imperial drawing) |
Check INSUNITS in both files. Set correctly and re-attach. Use ALIGN to fix if already placed. |
| Xref appears in wrong location |
Source drawing not drawn at origin; coordinate mismatch |
Set insertion point to 0,0 and use MOVE or ALIGN. Ask source team to set UCS to World and save near origin. |
| Circular xref warning |
Drawing A references B, B references A |
Change one of the references to Overlay type. Restructure so one drawing is always the base. |
| Xref layers keep resetting visibility |
Xref reload resets layer overrides |
Save a Layer State before reload; restore after. Or set VISRETAIN = 1 (default — keeps host overrides). |
| Can't select xref objects |
Xref layer is locked, or PICKSTYLE blocks it |
LA → unlock xref layers. Or use REFEDIT to enter the xref for editing. |
| Xref shows wrong linetype scale |
PSLTSCALE mismatch or LTSCALE in source differs |
Set PSLTSCALE = 1 in host. Xref inherits LTSCALE from host (VISRETAIN controls this). |
| Xref faded too much / not enough |
XDWGFADECTL value |
Type XDWGFADECTL → set 0–90 (0 = no fade, 70 = standard). Value stored per drawing. |
| Nested xref missing after attach |
Nested xref path broken in the parent xref file |
Open the parent xref directly → fix the nested xref path there → save → reload in host. |
| Bind creates duplicate named objects ($0$, $1$) |
Host and xref share layer/style names |
Normal behavior — AutoCAD increments suffix. Use PURGE after bind to clean up unused layers. |
Xref vs Other Reference Types
| Type | Command | File Types | Editable | Best For |
|---|
| DWG Xref | XATTACH | .dwg | Via REFEDIT | Base plans, coordination drawings, sheet production |
| Image | IMAGEATTACH | .jpg, .png, .tif, .bmp | No | Aerial photos, scanned plans, logos |
| PDF Underlay | PDFATTACH | .pdf | Snap to geometry only | Redline markups, client-supplied PDFs for tracing |
| DGN Underlay | DGNATTACH | .dgn (MicroStation) | No | DOT / civil drawings delivered in MicroStation format |
| Point Cloud | POINTCLOUDATTACH | .rcp, .rcs | No | Scan-to-BIM, field survey point cloud data |
| Coordination Model | CMATTACH | .nwc, .nwd | No | Navisworks clash detection coordination |
Questions & Tips
Share an xref workflow tip or ask about a specific scenario.