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.

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, the add-in can download updates but may not be allowed to apply them. Ask IT to push the current StructuredAI-AllUsers.msi, or run Revit elevated once to let the pending update apply.
  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.
  • Access keys can be reviewed and revoked per device from your account settings in the web app, and by your organization's admins.

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 remembers your corrections and conventions per project, so it doesn't re-ask what it already learned about how your models are organized.

tip

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