gstarcad-troubleshooting

XREF changes are not detected or updated automatically

In short

GstarCAD can detect when an external reference (XREF) has been modified, but it does not automatically reload the changed XREF. Set XREFNOTIFY to 2 and XNOTIFYTIME to 1 so GstarCAD checks for modified external references every minute and notifies the user when a change is detected.

Problem

When working with DWG files that contain external references (XREFs), changes made to the referenced drawing may not appear immediately in the host drawing.

For example, a project may contain multiple XREF files, with an architectural base model attached to plumbing, heating, electrical, or other discipline drawings.

If a user modifies an XREF file, saves and closes it, and then returns to a DWG file that references it, GstarCAD can notify the user that the external reference has been modified. However, the changes are not automatically applied to the current drawing.

Solution

This is the expected behavior and is consistent with AutoCAD. GstarCAD provides an update notification so that the user can decide whether to reload the modified XREF and retain the changes.

The frequency at which GstarCAD checks for modified XREF files can be controlled using the following system variables:

System variable Recommended value Description
XREFNOTIFY 2 Enables the notification for modified external references.
XNOTIFYTIME 1 Sets the checking interval to 1 minute.

Check the XNOTIFYTIME value

If XNOTIFYTIME is set to a high value, for example 300, the notification may be significantly delayed. This can make it appear as if GstarCAD is not detecting changes to the XREF.

Recommended settings

Enter the following commands in the GstarCAD command line:

XREFNOTIFY
2
XNOTIFYTIME
1

Expected result

After applying these settings, GstarCAD will check for modified XREF files every minute and notify the user when an external reference has changed.

Note

The XREF is not automatically reloaded. The notification is intended to allow the user to decide whether the modified external reference should be updated. This behavior is by design and is consistent with AutoCAD.

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.