01 / 20

Linked Model
Troubleshooting

Learn to resolve visibility issues and coordinate misalignment when working with linked Revit models in collaborative BIM projects.

Autodesk Revit

What Are Linked Models?

In Revit, a linked model is an external .rvt file referenced inside your host project. This lets multiple disciplines: architecture, structure, and MEP: work simultaneously on separate files while seeing each other's work in context.

Why Linking Matters in BIM

Collaboration
Multiple teams edit their own files without overwriting each other's work.
Coordination
Clash detection and spatial checks work across linked models in real time.
Performance
Splitting large projects into linked files keeps each file lightweight and responsive.

The Two Core Problems

Visibility Issues
Linked model elements disappear, appear as wireframe, or fail to display in certain views. This is usually controlled by Visibility/Graphics Overrides.
Coordinate Issues
Linked models appear offset, rotated, or at the wrong elevation. This stems from mismatched shared coordinates or wrong positioning methods.

Visibility/Graphics Overrides

Host View Model Categories Linked Model Display Filter Overrides Workset Visibility Revit Links Tab Display Setting: By Host View Display Setting: By Linked View Display Setting: Custom Controls what you see from the linked file

Display Settings: Three Modes

1
By Host View: The host project's VG settings control linked element visibility. Linked elements follow whatever the current view shows.
2
By Linked View: You pick a specific view from the linked file to use. That view's VG settings, filters, and detail level are applied.
3
Custom: You manually override individual categories of the linked model, independent of both host and linked views.

Shared vs. Project Coordinates

Project Base Point (Internal Origin) Building A Survey Point (Shared Coordinates) Building B Shared Coordinates Align Real-World Position N/S, E/W, Elevation
Project Coordinates
Local to each file. The Project Base Point defines the internal origin. Different files can have different project origins.
Shared Coordinates
A common real-world reference. When properly set, all linked files align to the same geographic location via the Survey Point.

Positioning: Auto vs. Manual

Auto - By Shared Coordinates Manual - Origin to Origin
How it works Uses Survey Point alignment Matches internal origins
When to use Shared coords are set up Quick test or coords not set
Accuracy Real-world correct Depends on origin placement
Multi-building Correct spacing All stack on origin
Risk Low (if coords match) High offset if origins differ

Step-by-Step Troubleshooting

1
Check the Manage Links dialog: Confirm the linked file's status is "Loaded" (not "Not Loaded" or "Not Found"). Reload if necessary.
2
Open Visibility/Graphics (VV): Go to the Revit Links tab. Ensure the link is checked "on" and the display setting is correct.
3
Verify positioning method: Select the link instance, check Properties. Confirm it uses "Auto - By Shared Coordinates" for proper alignment.
4
Check Worksets: If using Worksharing, ensure the linked model's workset is visible in the view and globally open.
5
Inspect shared coordinates: Use "Acquire Coordinates" or "Publish Coordinates" to synchronize real-world positions between host and link.

Example: The Invisible Link

Scenario: You linked the structural model, but nothing appears in your floor plan view. The link shows as "Loaded" in Manage Links.

Floor Plan View (empty) FIX After VG Fix Structural grid visible

Example: The Offset Link

Scenario: The MEP model appears 150 feet north of the architectural model. Both files were modeled at different origins.

ARCH Model MEP Model 150 ft offset Correct position

Example: Partially Visible Link

Scenario: You can see the linked model's walls but not the doors and windows. The link is loaded and positioned correctly.

1
Check category-level overrides: In VV → Revit Links tab, expand the link and verify that Doors and Windows categories are checked on.
2
Check View Range: Doors and windows may fall outside the view's cut plane range. Adjust the Top and Cut Plane offsets.
3
Check detail level: At Coarse detail level, some nested families (like window mullions) may not appear. Switch to Medium or Fine.

Acquire vs. Publish Coordinates

Host Model Survey Point Linked Model Survey Point Acquire Publish Both sync shared coordinates Direction determines which file updates
Acquire Coordinates
The host "pulls" the linked model's survey point data into itself. The host file updates. Use when the link has the correct real-world position.
Publish Coordinates
The host "pushes" its survey point data to the linked file. The linked file updates. Use when the host has the correct real-world position.

Common Mistakes

✕ Using "Center to Center"
Positioning a link with "Center to Center" ignores coordinate systems entirely, causing unpredictable placement. Always use shared coordinates.
✕ Pinning a Misaligned Link
Pinning a link before verifying its position locks the error in place. Always confirm alignment first, then pin to prevent accidental moves.
✕ Ignoring Workset Visibility
The linked model's workset may be closed or hidden in the view. Check both global Worksets dialog and the view's VG Worksets tab.

Troubleshooting Quick Reference

Symptom Likely Cause Fix
Link not visible at all Link not loaded or VG off Reload + check VG
Link is offset Wrong positioning method Set to Shared Coords
Partial visibility Category or workset hidden Expand link in VG
Link at wrong elevation Mismatched shared coords Acquire/Publish coords
Link appears as wireframe Visual style override Check VG halftone

Question 1 of 5

A linked structural model is loaded but completely invisible in your floor plan view. What should you check first?

Question 2 of 5

Your linked MEP model appears 150 feet away from your architectural model. The link is loaded and visible. What is the most likely cause?

Question 3 of 5

What does "Acquire Coordinates" do when applied to a linked model?

Question 4 of 5

You can see walls from a linked model, but doors and windows are missing. Which of the following is least likely to be the cause?

Question 5 of 5

In the Visibility/Graphics Revit Links tab, what does the "By Linked View" display setting do?