Skip to main content

Connect Revit

The Revit add-in puts Structured inside Revit. Chat with the agent about the live model and push or pull element corrections without switching windows.

Use case: fix a mismatched door tag in chat and push the correction straight back into the model.

Updated video coming soonConnect Revit

Installing the add-in​

Watch the installation walkthrough, or follow the steps below:


Requirements​

  • Windows with Autodesk Revit 2022-2027 (any or all years - one installer covers them)
  • An active Structured account. The add-in requires sign-in: without an account it installs, but every feature stays locked behind the sign-in screen.
  • Internet access from the Revit workstation
  1. Download StructuredAI.msi
  2. Run it. The installer is per-user - no admin rights needed - and automatically detects every Revit version installed on the machine.
  3. Start (or restart) Revit. A Structured AI tab appears in the ribbon.
  4. Click Open Structured AI on that tab. The panel opens and shows the sign-in page.
  5. Click Sign in with your browser. Your default browser opens so your saved passwords and SSO work. Approve Authorize Revit Plugin there and the panel continues on its own. This links the add-in to your organization's projects.
Video / photo coming soon

The Structured AI tab in the Revit ribbon, with the Open Structured AI button

The publisher on the installer prompt reads STRUCTURED SOFTWARE, INC. If Windows SmartScreen shows "Windows protected your PC" (it can for recently released installers), click More info → Run anyway after confirming the publisher name.

The add-in keeps itself up to date automatically - no need to reinstall for updates.

IT-managed install​

For centrally managed workstations there is a per-machine variant, StructuredAI-AllUsers.msi, intended for deployment by IT (requires elevation, installs to %ProgramData%). Prefer the per-user MSI above unless your IT policy requires machine-wide installs.

A machine-wide install still receives updates: the add-in keeps its current build in each user's profile and loads that in preference to the installed baseline, so no elevation is needed. Pushing a newer MSI always takes precedence over the cached build. To pin the version instead, set the registry value HKLM\SOFTWARE\StructuredAI\ManagedInstall to 2 - the add-in then stops updating itself and only a new MSI changes the build.

Both links always serve the newest release. Every published version - with its build id and per-version downloads - is listed on the releases page.

Alternative: one-line install script​

If you'd rather not run an MSI, the download page has a one-line PowerShell install. Open PowerShell on your Revit workstation and paste:

iwr https://api.getstructured.ai/api/revit/plugin-download/install.ps1 | iex

Uninstalling​

Remove Structured AI for Revit from Windows Settings → Apps, like any other program.

Updating the add-in​

The add-in updates itself: on startup it checks for a newer build, downloads it in the background, and applies it the next time Revit closes - so a routine update is just close and reopen Revit.

The panel tells you when your installed add-in is out of date (a banner at the bottom of the pane). Don't ignore it: an outdated add-in is the most common cause of otherwise-mysterious problems - sign-in that never completes, live-model tools missing from chat, or features that work in the browser but not in Revit.

To fix an outdated add-in, in order:

  1. Close and reopen Revit. If an update was already downloaded, this applies it. Check whether the banner is gone.
  2. Still out of date? Download StructuredAI.msi and run it - it installs per-user (no admin rights needed), replaces the old add-in in place for every Revit version on the machine, and keeps your sign-in. Then restart Revit.
  3. On an IT-managed (per-machine) install, updates normally apply on their own too - the add-in keeps its current build in your user profile, so closing and reopening Revit is still the fix. If the banner says the update needs elevation, the machine has an older loader: run Revit as administrator once, then close and reopen it, or ask IT to push the current StructuredAI-AllUsers.msi. If IT has pinned the add-in version, only a new installer from IT changes it.
  4. If none of that clears it, grab %APPDATA%\StructuredAI\debug.log and contact support - the log records exactly what the updater tried.

Signing in and access control​

Everything the add-in does - chat, QA/QC checks, sending model data, applying corrections - runs through your Structured account:

  • On first use the panel shows the sign-in page. Once you sign in, the add-in stores a device-scoped access key for your account.
  • If you're not signed in (or your account is deactivated), the add-in shows the sign-in screen and nothing else - there is no offline or anonymous mode.
  • Sign-in is per device: one key per workstation, so signing in on a second machine doesn't sign you out of the first. Signing in again on the same workstation rotates that machine's key rather than adding another.
  • Revoking a device's access is a support request today, not a self-service screen. If a workstation is lost or leaves the team, tell us and we'll revoke that key. Deactivating the person's Structured account also stops the add-in working on every device they signed in on.

Connecting a model to a project​

The panel's home page ties the open model to one of your Structured projects:

  • Connect to existing project lets you pick from your projects.
  • Create project starts a new project from a drawing set, specs or standards.
  • When the panel recognises the model, it suggests a project, for example one you or a teammate connected this model to before. Click the suggestion to connect in one step.

Once connected, the home page shows a Connected card with Open project chat, Change project and Disconnect, and the project page shows a Live model chip.

Video / photo coming soon

The Revit panel home page with Create project, Connect to existing project and a suggested project

Chatting with the model​

The add-in hosts the same chat agent you use in the browser, but connected to the live model:

  • Ask about elements, parameters, schedules, and views in the open model.
  • Cross-reference the model against the drawing sets in your Structured project.
  • When the agent names an element, it is a link: click it to select that element in Revit. This works for elements in linked models too.
  • Ask the agent to look at the model: it can capture the active view, or a specific view or sheet, as an image and reason about what it sees.

While the agent works in the model, Revit may pause for a few seconds and the panel shows a "Working in Revit" notice. That's normal.

Making changes from chat​

When the agent proposes a model change (fixing a tag, updating a parameter, or correcting an element), it shows you exactly what it wants to do and waits for you to click Approve & run before touching the model. Nothing runs without your explicit approval, and every change is visible in the panel.

  • Decline cancels the change.
  • Give feedback sends the agent a note (for example "only apply this to Level 2") without running anything.
Video / photo coming soon

An approval card in the Revit panel with Decline, Give feedback and Approve & run

Takeoff​

The panel has a Takeoff tool that counts quantities live from the open Revit model and its linked models, for every discipline: architectural, structural, civil/site, mechanical, plumbing, fire protection, electrical, fire alarm, low voltage, technology / data and security. Devices, fixtures and equipment are counted; duct, pipe, conduit and cable tray are measured as length by size, with their fittings counted. Areas and concrete volumes work as before.

  1. Open Takeoff from the panel's tools and click Run takeoff. The add-in scans the model and each loaded link, and lists only the items it found, grouped by discipline. Show everything brings back the rest, greyed out.
  2. Choose which linked models to include. A link placed more than once is counted once; turn on Count every placement when the copies are real (a unit or floor placed many times). Nested links (a link inside another link) are read too and marked with a small link icon. Revit can't highlight their items from the open model: open that linked model on its own, then click the item again.
  3. Tick the items you want (Select all, tick all per discipline and Clear help), or Add item to take off another model category.
  4. Click Run selected. Devices and fixtures are grouped by room, equipment by level, lengths by size and concrete by mix; one click changes the grouping. Quantities use the model's own units (Manage › Project Units), which you can switch to metric or imperial.
  5. If Revit takes too long, the results say Partial and Run the rest continues where it stopped. Nothing is cut off silently.
  6. Export PDF or Export Excel the results, or Save workflow to rerun the same takeoff later.

You can also ask the agent in chat to build or reshape a takeoff, and the Takeoff tool updates in front of you. Takeoff only appears inside the Revit add-in, because it reads the live model.

Memory​

The Revit agent shares project memory with the browser chat, so a correction or convention you record in one shows up in the other. Tell it once how your models are organized and it won't re-ask.

What the add-in doesn't do​

The add-in's panel is for the live model, so the drawing-set tools (Overlay, Compare Versions, Compare Against Control, Comment Closure, Shop Drawing Review, Spec Audit, Board) aren't offered there. They're hidden rather than greyed out. Open the project in the browser for those.

tip

There's a "Connect Revit" walkthrough video in the app: Help menu → User Guide → Connect tools.