AutoCAD XA Shortcut : XATTACH : Inserts A DWG File As An External Reference (xref)

If you need a clear, step-by-step guide to using the xattach shortcut in AutoCAD, this article explains what the command does, how to use it, why it can fail, useful alternatives, troubleshooting steps, and practical tips to manage external references (xrefs) effectively.

Table of Contents

What is the XATTACH shortcut?

The xattach shortcut (command: XATTACH or launching via the Xref palette) lets you insert a DWG file as an External reference (xref) into the current drawing. An xref links one drawing to another without merging the source geometry into your active DWG. This preserves the original file and keeps the host drawing smaller and easier to manage.

Key points:

XATTACH inserts an external DWG as an attached xref (or overlay depending on option chosen).
Xrefs are referenced, not imported — changes to the source DWG update automatically when reloaded.
Xrefs display with a filename prefix on layers (e.g., floorplan.dwg|WALLS), making source/host separation clear.

When to use XATTACH

Use XATTACH when you want to:

Reuse a floor plan, site plan, or detail across multiple drawings without duplicating geometry.
Collaborate with team members who maintain separate source files.
Maintain updatable references for multi-discipline projects (architecture, MEP, structural).
Keep your file size smaller and editing operations faster.

Step-by-step: How to use XATTACH in AutoCAD

1) Open the host drawing

Open the drawing where you want to reference another DWG.

2) Start the command

Type XATTACH in the command line and press Enter.
Or open the External References palette (type XREF) and click Attach DWG.

3) Select the DWG to attach

In the dialog that appears, browse to the DWG file and select it.

4) Choose insertion options

You will be prompted or given dialog options for:

Path Type: choose Full Path, Relative Path, or No Path. Use Relative Path when files are kept in a consistent folder structure across users or projects.
insertion point: either check Specify on-screen to place the reference manually, or leave it unchecked and enter coordinates.
Scale: accept default (1,1,1) or specify scale factors. You can also choose Specify on-screen.
Rotation: set a rotation angle or choose on-screen.
Attach/Overlay: decide whether the DWG is Attached (acts like a referenced DWG that can be bound) or Overlayed (will not be nested into another drawing when attached as an xref). Use Overlay for base files reused across disciplines to prevent nested propagation.

5) Place the xref on-screen (if chosen)

If you selected on-screen placement, click to set the insertion point and scale.

6) Manage the xref

Open the Xref Manager (type XREF) to:

Reload, detach, bind, unload, or change the path.
Toggle visibility and set clipping or layers.

Alternative commands and methods

XREF: Opens the External References palette where you can attach, detach, reload, and manage xrefs.
INSERT: Inserts a DWG as a block (permanently copies geometry into the current drawing). Use for one-off imports you intend to edit.
ATTACH (Image/PDF): For raster images or PDFs, use ATTACH > Image or PDFATTACH.
BIND (from XREF manager): Converts xref into local block permanently (two options: Bind or Insert).
DesignCenter (ADCENTER): Browse drawings and drag items into your drawing; can be used to bring in blocks or content.
Reference Manager (standalone tool) — useful for bulk path fixes and managing xrefs across many files.

Common issues: Why XATTACH may not work and how to fix

File not found / broken path

Symptom: xref shows as unresolved or with a red “Not Found” indicator.
Fix: In XREF Manager, right-click the xref and select Find and Replace or Select New Path. Use Relative Path when possible and ensure shared network drives are mapped consistently.

Version incompatibility

Symptom: error opening or attaching because source DWG is newer than your AutoCAD version.
Fix: Open the source DWG in a newer AutoCAD and save-as to a compatible version, or use Autodesk DWG TrueView to convert.

Permissions or network issues

Symptom: cannot open or reload xref from network location.
Fix: Check file/folder permissions, map the network drive, or copy files locally.

Corrupt DWG file

Symptom: crashes, errors, or blank xref.
Fix: open source file and run AUDIT and RECOVER, then reattach.

Xrefs not updating

Symptom: edits in source DWG are not reflected in host.
Fix: In XREF Manager, select the xref and click Reload. Ensure XREFOVERRIDE is not preventing updates, and that you’re editing the actual source file.

Layers invisible or locked

Symptom: xref geometry not visible or dimmed.
Fix: Check the Layer panel for xref layers (they use a prefix like filename|layer). Turn layers on/unfreeze/unlock or use the XREF override settings.

Clipped or clipped incorrectly

Symptom: parts of Xref missing due to clipping boundary.
Fix: In XREF Manager, right-click the xref > Clip Xref > Remove or edit the clip polygon.

Nested xrefs and Overlay vs Attach confusion

Symptom: nested references unexpectedly appear or disappear.
Fix: Use Overlay when you don’t want nested propagation. Understand that Attach will carry nested xrefs when you bind or when another drawing attaches your host.

Xref layers altering host drawing styles (plotting, linetypes)

Fix: Use REFEDIT cautiously. Use LAYER commands to control visibility and create layer standards. Consider BIND to convert when finalizing.

Tips and best practices

Always maintain a consistent folder structure and prefer relative paths for xrefs in team environments.
Use Overlay for reference files that should not be nested into other drawings.
Use Bind only when you want to make an xref permanent in the host drawing (e.g., final deliverable). Understand the difference between Bind and Insert binding options.
Name source DWGs clearly (e.g., project_floor_01.dwg) to avoid confusion in the layer prefix.
Use AUDIT and PURGE regularly on both source and host drawings to reduce corruption and bloat.
For large projects, consider an xref naming and folder convention documented for all team members.
Use the Reference Manager to fix many xref path issues in batches.
Lock or thaw layers deliberately; be careful when editing xref layers — prefer editing the source file.
When sharing projects across different machines, compress and include the xref folder or use a shared repository with consistent paths.

Examples: Before and after using XATTACH

Before: Host drawing contains only boundary and notes; team members maintain floorplan.dwg separately.
Action: Use XATTACH to attach floorplan.dwg with Relative Path and Overlay.
After: Host displays the floorplan as an xref; layer names show as floorplan.dwg|LayerName; updates to floorplan.dwg reflect in the host after Reload.
Before: You inserted a DWG with INSERT and had duplicate geometry across files.
Action: Replace the inserted block with an xattach to keep a single source of truth.
After: Edits centralized in the source file, host file size reduced, easier collaboration.

FAQ

How do I convert an xref into native geometry in my drawing?

Use the BIND function from the XREF Manager. Right-click the xref > Bind or Insert (Bind converts layers with prefixes; Insert merges without prefixes). Save a backup before binding.

How can I change an xref path from absolute to relative?

In the XREF Manager, right-click the reference and choose Change Path or use the Path Type dropdown to set Relative. Save both drawings in the same folder structure for the relative path to work.

Why does an xref appear as a blank box or not display correctly?

Possible reasons: missing support files, version mismatch, corrupted DWG, or clipping. Try Reload, run AUDIT on the source, and check clipping settings.

How do I prevent xref layers from plotting?

Turn off plotting for those layers via the layer properties Manager (set the printer icon to No Plot) on the xref layers, or create a Layer state for plotting.

How do I reload all xrefs at once?

Open XREF Manager and choose Reload All (or right-click in the manager and select Reload for multiple selections).

Can I attach a PDF the same way as a DWG?

Use PDFATTACH (or Attach > PDF) to reference PDFs. PDFs behave similarly but with different editing capabilities — they are raster/vector overlays, not editable geometry like DWGs.

Why do xref layer names include the filename prefix?

AutoCAD prefixes layer names with the xref filename (e.g., file.dwg|Layer) to avoid naming conflicts and to identify layer origin. Use Bind to remove prefixes if you need to merge layers permanently.

How do I detach an xref I no longer need?

Open XREF Manager, right-click the xref and choose Detach. Detaching removes the reference link and any dependency.

My xref looks different on another computer — how do I fix that?

Check that both systems have the same support files, fonts, linetypes, and mapped drives. Use relative paths, share the same folder structure, or include the xref folder with your DWG package.

Is there a way to batch-fix broken xref paths for many drawings?

Yes — use the Reference Manager or scripts to update paths in bulk. Reference Manager can search and replace paths across many files.