Help

How to: Resolve annotation and add-on symbol offset issues in Revit 2024+

Modified: 27 Aug 2026 Stabicad
Not version-specific
Stabicad
Understanding the Issue When placing electrical or mechanical components with linked add-on symbols in Revit 2024+, modelers frequently faced visual displacement of the annotations. This offset was caused by how Revit processed grouped configurations of nested annotations and add-on families. The manual ungrouping and regrouping workaround was time-consuming and prone to human error.
The Structural Solution (Implemented in v26.08)
The updated workflow eliminates the requirement to group add-on and annotation families together in Revit, resolving the offset issue entirely. This was achieved through coordinated updates:
  • Content Team Updates: The Offset option and its associated parameters were added to the base annotation families used to generate add-on families. All add-on families across all localizations were then regenerated using the Family Creator tool.
  • Electrical Team Code Changes: Stabicad's code was updated to ensure that the add-on family is excluded from the Revit Group when placed. The Group now contains only the annotation family. The add-on is placed directly at the annotation family's insertion point, and the offset parameters are programmatically linked under the hood.
Step-by-Step: Applying the Fix to Existing Projects
New projects started directly in Stabicad 26.08 or 26.09 work out of the box. However, if your project was started in an older version (e.g., 26.03), simply upgrading Stabicad is not enough because the active families in the project database still contain the old parameter structures. Follow these steps to apply the fix:
Step 1: Upgrade Stabicad
  • Install Stabicad 26.08 or 26.09 (or newer) on your workstation.
Step 2: Convert the existing families
  1. Open your active Revit project.
  2. In the Stabicad Electrical ribbon, click on Convert families to Current version

 

⚠️ CRITICAL WARNING: Prevent Fatal Errors Caused by Local Disk Space Depletion
When converting and reloading these families in existing, large central models (e.g., multi-story coordination models), Revit must run a one-time conversion of all placed symbols.
  • The Risk (Swapfile Growth): During this conversion, Revit generates a temporary swapfile on your local hard drive (typically the C:\ partition). For large projects, this file can grow immensely during processing.
  • The Consequence: If your local hard drive runs out of space during the conversion process (testing on large central files showed the process can take up to 60 minutes before completely filling the local drive), Revit will crash instantly with a Fatal Error, risking model corruption.
  • Action Required Before Converting:
    1. Ensure your local drive (SSD) has at least 50 GB to 100 GB of free space before opening and converting an existing central model.
    2. It is highly recommended to perform this conversion once on a high-performance workstation. Once the converted model is successfully synchronized with the central file, other team members will not need to repeat the process.

 

Submit