GstarCAD command

XATTACH command

Attach another DWG drawing as an external reference with control over path, reference type, insertion point, scale and rotation.

Command
XATTACH
Alias
XA
Tool group
Insert
Level
Intermediate

What does XATTACH do?

XATTACH attaches another DWG drawing to the current drawing as an external reference, commonly called an Xref. The referenced geometry remains linked to the original DWG file instead of becoming permanent geometry in the host drawing. This makes Xrefs useful for coordinating architectural, structural, mechanical and other project drawings that may be updated independently.

How to use the command

  1. Type XATTACH or its shortcut XA, then press Enter.
  2. Select the DWG file that you want to use as an external reference.
  3. Choose Attachment or Overlay as the reference type.
  4. Select the required path type: Full path, Relative path or No path.
  5. Set the insertion point, scale and rotation, or choose to specify these values on screen.
  6. Confirm the settings and place the Xref in the drawing.
Command: XA ↵
Reference file: Architecture.dwg
Reference type: Overlay
Path type: Relative path
Insertion point: 0,0
Scale: 1
Rotation: 0

Key XATTACH options

The attachment settings control how the external drawing is positioned and how its relationship with the host drawing is maintained.

Attachment
Attaches the DWG as an Xref and allows its nested external references to remain part of the reference chain when the host drawing is referenced elsewhere.
Overlay
Attaches the DWG without carrying its nested reference relationship into drawings that later reference the current host drawing.
Relative path
Stores the reference location relative to the host drawing, which is useful when project folders are moved while their internal structure remains unchanged.
Full path
Stores the complete file location of the referenced DWG.
No path
Stores only the reference file name rather than its complete folder path.
Insertion settings
Control the Xref insertion point, X, Y and Z scale factors and rotation angle.

Practical example: attach an architectural background

Suppose a structural drawing needs Architecture.dwg as a coordination background. Start XATTACH, select the architectural file and choose Overlay with a Relative path. Set the insertion point to 0,0, scale to 1 and rotation to 0. The architectural drawing remains linked to its source file and can later be updated using XREF.

Tip

Relative paths are often convenient for project folders because the reference can continue working after the complete project folder is moved, provided the relative folder structure remains the same.

All commands Updated 30 September 2026
Continue learning
View all commands

Ready to switch to GstarCAD?

Get personalized advice on licensing, migration, and deployment for your business.

Contact us Buy now

No obligation — reply within 24h

Your Cart

Subtotal

Price does not include local taxes or duties.

Proceed to Checkout

Cookie preferences

Choose which cookies you want to allow. Essential and payment cookies cannot be disabled as they are required for the site to function.

Essential

Required

Core functionality including authentication, shopping cart, and language preferences.

Payment

Required

Required for processing payments securely through Stripe and PayPal.

Analytics

Help us understand how visitors interact with our site to improve the experience.

Marketing

Used to deliver relevant advertisements and measure campaign performance.

Functional

Order attribution and traffic source tracking to help us understand how customers find our store.