How to Run a Dynamo Script in Revit
To run a Dynamo script in Revit, open the Manage tab, click Dynamo, then Open in the Dynamo editor and browse to your .dyn file. Click Run. To let users without Dynamo experience run it, drop the .dyn into the Dynamo Player folder and they can run it with one click from Manage → Dynamo Player.
Steps
Open Revit and a host model
Most Dynamo scripts operate on an active document. Open the project (.rvt) you want to apply the script to before launching Dynamo.
Launch Dynamo
Go to Manage → Dynamo. The Dynamo home screen opens. If Dynamo isn't installed (older Revit versions), install it from the Autodesk App Store.
Install required packages
If the graph relies on community packages (Clockwork, archi-lab, Rhythm, etc.), install them from Packages → Search for a Package before opening the graph. Missing packages show as yellow warning nodes.
Open and inspect the graph
File → Open, browse to the .dyn. Read any vendor-provided notes inside the graph (often as Note nodes). Confirm input nodes match your model — pick the right view, level, or category.
Run the graph
Click Run at the bottom-left. Watch for red error nodes — most are caused by missing packages or expecting elements that don't exist in your model. Use the Preview popup on each node to inspect intermediate values.
Deploy to teammates with Dynamo Player
Copy the .dyn into the team's Dynamo Player folder (the path is set in Manage → Dynamo Player → Edit Folder). Mark important inputs as 'Is Input' in the graph so they appear as form fields in Player. Now teammates can run the script from a simple dialog without Dynamo experience.
Frequently asked questions
Why do I see yellow warning triangles on nodes?
Almost always missing custom-node packages. Open Packages → Search for a Package, install the one the graph needs, restart Dynamo, reopen the .dyn.
Dynamo Player shows my script but the inputs look wrong.
Open the graph in the full Dynamo editor and mark the right input nodes with 'Is Input' (right-click the node). Save. Dynamo Player rereads inputs from the saved file.
Is Dynamo available in Civil 3D?
Yes — Dynamo for Civil 3D ships as an in-product add-in starting Civil 3D 2020. The graphs are similar but use a different set of Civil 3D-specific nodes (Alignment, Corridor, Profile).
Can I run a Dynamo graph without opening the editor?
Yes — Dynamo Player is exactly this. There's also a Journal-based command-line run for batch processing, used by automation pipelines.
How do I know if a graph will modify my model?
Dynamo graphs that change Revit elements always run inside a Revit transaction, which is visible in your Undo stack. Always run an unfamiliar graph against a copy of your model first.
Browse listings
Verified Dynamo graphs (.dyn) and custom nodes (.dyf) for Revit and Civil 3D — Player-friendly, package-light, with documented inputs and outputs.
Verified Dynamo graphs for Revit: sheet automation, parameter management, family helpers, schedule cleanup. Player-friendly with documented inputs and required packages.
Related terms
Autodesk's visual programming environment, used inside Revit and Civil 3D to automate model and design tasks with node graphs.
A single function block in a Dynamo graph — the unit you wire together to build an automation.
A simplified Dynamo runner inside Revit/Civil 3D that lets non-Dynamo users run vetted .dyn graphs by clicking a button.
The textual scripting language Dynamo's code blocks use — a stricter cousin of Python with stronger type safety.
Autodesk's Building Information Modeling (BIM) authoring tool. Automated primarily with Dynamo and the Revit .NET API.