Docs
Workflow
Debugging Visibility Issues -- Why Can't I See My Element?
Systematic approach to diagnosing why elements are hidden or invisible in a Revit view.
debuggingvisibilitydiagnosticstroubleshootingviewsfilters
Last updated: 2026-04-16
Systematic approach to diagnosing why elements are hidden or invisible in a Revit view.
Last updated: 2026-04-16
"Why can't I see my element?" is one of the most common questions in Revit. Elements can be hidden for a dozen different reasons, and tracking down the cause manually is tedious. This workflow uses Pyvoid's diagnostic tools to systematically identify and fix visibility problems.
flowchart TD
Start["Element not visible"] --> XRay{"Use X-Ray?"}
XRay -->|Yes| Auto["X-Ray Auto-Diagnosis"]
XRay -->|No| C1
Auto --> Result["Shows which check failed\n+ one-click fix"]
C1["Category\nVisibility"] -->|OK| C2["Subcategory\nVisibility"]
C2 -->|OK| C3["Filter\nOverrides"]
C3 -->|OK| C4["View\nRange"]
C4 -->|OK| C5["Crop\nRegion"]
C5 -->|OK| C6["Workset\nVisibility"]
C6 -->|OK| C7["Design\nOption"]
C7 -->|OK| C8["Phase\nFilter"]
C8 -->|OK| C9["Hidden\nin View"]
C9 -->|OK| C10["Detail\nLevel"]
C10 -->|OK| C11["Linked Model\nVisibility"]
C11 -->|OK| C12["Geometric\nScope"]
C12 -->|OK| C13["Compare\nViews"]
C1 -->|Found| Fix["Fix the cause"]
C2 -->|Found| Fix
C3 -->|Found| Fix
C4 -->|Found| Fix
C5 -->|Found| Fix
C6 -->|Found| Fix
C7 -->|Found| Fix
C8 -->|Found| Fix
C9 -->|Found| Fix
C10 -->|Found| Fix
C11 -->|Found| Fix
C12 -->|Found| Fix
style Start fill:#ef4444,color:#fff,stroke:#dc2626
style Fix fill:#10b981,color:#fff,stroke:#059669
style Auto fill:#3b82f6,color:#fff,stroke:#2563eb
style Result fill:#3b82f6,color:#fff,stroke:#2563ebTool: X-Ray
For most visibility issues, X-Ray is the fastest path to an answer.
X-Ray checks these conditions in order:
| Check | What It Tests |
|---|---|
| Category Visibility | Is the element's category turned off in V/G? |
| Subcategory Visibility | Is a subcategory hidden? |
| Filter Overrides | Is a view filter hiding the element? |
| View Range | Is the element outside the view's cut plane range? |
| Crop Region | Is the element outside the crop boundary? |
| Workset Visibility | Is the element's workset hidden? |
| Design Option | Is the element in a non-active design option? |
| Phase | Is the element in a different phase than the view? |
| Element Hidden | Was the element individually hidden (Hide in View)? |
| Detail Level | Is the element only visible at a different detail level? |
| Linked Model Visibility | Is the element in a link whose visibility is off? |
Each failed check includes a one-click fix button where applicable (e.g., "Turn on category" or "Expand crop region").
If X-Ray is not available or you want to understand the process, work through these checks manually.
Tool: Find Referring Views
Select the element (from the Project Browser, a schedule, or another view where it is visible) and run Find Referring Views. This shows every view where the element exists. If the problem view is not in the list, the element may be outside the view's scope entirely.
Tool: Show View Range
For plan views, the most common visibility issue is view range. The element may be above the cut plane or below the view depth.
Fix: Adjust the view range (View Properties > View Range) to include the element's elevation.
Open the Visibility/Graphics dialog (keyboard shortcut: VV or VG) and check:
If the view has a crop region enabled, verify the element is within the crop boundary. Use the Crop Region tools in the Sheets panel to adjust if needed.
Check if an active Temporary Hide/Isolate is affecting the view. Look for the blue boundary at the bottom of the view. If present, click the lightbulb icon and choose "Reset Temporary Hide/Isolate."
The element may have been individually hidden with Revit's "Hide in View" > "Hide Element" command. To check:
If the project uses Design Options, verify:
Check the view's Phase and Phase Filter settings:
Almost always a view range issue. The element's elevation is outside the plan's cut plane range. Use Show View Range to confirm.
Check if the two plans have different view templates applied. Different templates may have different V/G settings or different view ranges.
The view template likely controls a V/G override or filter that hides the element's category. Use Template Diff to compare the template settings against a view where the element is visible.
The element may have a graphic override that makes it transparent or sets its line color to match the background. Check the element's override in the V/G dialog or use X-Ray to detect overrides.
Check for a workset visibility issue in the view. If the element's workset is hidden in the view's V/G Worksets tab, no amount of category visibility changes will make it appear.
Tool: Sync Views
When debugging, it helps to have the same area open in multiple views. Enable Sync Views to keep your navigation synchronized:
This is particularly useful when comparing two plan views at different levels or a plan and a 3D view.