Repository navigation
XREF Command
Hakan Seven edited this page Nov 8, 2026
·
1 revision
Opens the External References palette to attach, reload, unload, detach and bind references.
| Command |
XREF · -XREF
|
| Aliases | XR |
| Web app | In the web app the reference list is read-only; reference changes are not available. |
| Since | 0.1.4 |
- Run
XREF. The External References palette opens. - Select a reference in the list and use the toolbar or the right-click menu to work with it.
-XREF works on the command line and suits scripts. It asks Enter an option [?/Bind/Detach/Path/pathType/Unload/Reload/Overlay/Attach/Show] <Attach>:.
| Option | What it does |
|---|---|
| ? | Lists the references matching a name pattern (* lists all) with their type and path. |
Bind (B) |
Turns the named references into ordinary blocks of this drawing. |
Detach (D) |
Removes the named references. |
Path (P) |
Shows the old path of a reference and asks for a new one. |
pathType (T) |
Changes how the path is stored: Full (F), Relative (R) or None (N). |
Unload (U) |
Unloads the named references; they stay listed but are not shown. |
Reload (R) |
Reads the named references again from their files. |
Overlay (O) |
Asks for a file and attaches it as an overlay. |
Attach (A) |
Asks for a file and attaches it. Enter at the first prompt chooses this. |
Show (S) |
Opens the External References palette. |
Names accept the * and ? wildcards; if nothing matches you see No matching xref names found.
- The one-line form
XREF <option> <names>works too, for exampleXREF Reload *,XREF Path <name> <new path>orXREF Pathtype Relative <names>.XREF Path Find <old> <new>replaces a part of the path in every reference.XREF Overlay <names>changes existing references to overlays. - Relative paths are resolved from the drawing's folder, so save a new drawing before you reload its references.
XATTACH · EXTERNALREFERENCES · XRELOAD · XOPEN · XCLIP · REFEDIT
Open CAD Studio is free software under the GPL-3.0 licence · Source code · Download · Web app · Discussions
Get started
- Installation
- Your First Drawing
- Tutorials
- The User Interface
- Ribbon Reference
- Workspaces and Toolbars
- Navigating the Drawing
Draw and edit
- Drawing Setup and Units
- Precision Drawing
- Isometric Drafting
- Drawing Objects
- Multilines
- Selecting Objects
- Modifying Objects
- Hatches and Fills
- Layers and Properties
Annotate
Organise and reuse
Present and share
3D
Tools
Reference