Skip to main content

Connect Revit

The Revit add-in puts Structured AI 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.

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 AI 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 Sign in on the Structured AI tab and log in with your Structured AI account. This links the add-in to your organization's projects.

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 same bits can be installed with PowerShell from app.getstructured.ai → Download → Revit plugin, which also documents a fully manual copy-the-DLL install.

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 AI account:

  • On first use you sign in from the ribbon; 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 AI account also stops the add-in working on every device they signed in on.

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 AI project.

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 your Approve before touching the model. Nothing runs without your explicit approval, and every change is visible in the panel.

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 pane is for the live model, so the drawing-set tools (Compare, Overlay, Comment Closure, Shop Drawing Review, Spec Audit) aren't offered there - they're hidden rather than greyed out, because a lock you can never open just reads as a bug. 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.