Documentation

Documentation

One page for now. It will split into sections when there is enough to split.

Requirements

  • Revit: 2024, 2025, 2026 or 2027. One installer covers every version present on the machine.
  • Windows: 10 or 11, 64-bit.
  • Runtime: Nothing to install first: the desktop app ships self-contained (.NET 8 is included), and the Revit add-in runs on the runtime Revit already provides.
  • Network: none needed to run. See Licence & offline use.
  • Disk: the local cache holds the parameters you load, not the model geometry, so it is small relative to the model; it is rebuilt on demand and safe to delete.
  • Model size: the published measurements were taken on a medium commercial model (136 doors, 195 sheets, 193 warnings). The grid is designed to stay responsive at 100,000-plus rows by filtering rows rather than re-rendering, but that is a design target; no large or federated model has been benchmarked yet, and no figure is claimed for one.

Install & uninstall

Interactive

  1. Close Revit.
  2. Run IQTools-PerMachine-1.0.0.msi. It installs for all users of the computer and needs administrator rights; without them, ask IT, who can use the silent install below.
  3. Start Revit. IQ Tools is on the ribbon under IQTools (panel Main, button IQData).

Silent, for deployment tools

msiexec /i IQTools-PerMachine-1.0.0.msi /qn   &:: run elevated (administrator or SYSTEM)

The installer is signed by IQ Tools (an Authenticode signature issued through Microsoft's Azure Artifact Signing service, so the publisher shown on the MSI is IQ Tools). If SmartScreen shows a reputation warning on an early build, the signature is still the thing to check: right-click the MSI → Properties → Digital Signatures.

Uninstall

Windows Settings → Apps → IQ Tools → Uninstall, or msiexec /x with the same MSI. The add-in manifest, the ribbon entry and the per-project caches are removed. Your models are untouched: IQ Tools only ever wrote what you approved in a Sync Review, and that is ordinary Revit data.

If two copies load. A per-user install left from a beta build, alongside the per-machine one, makes Revit load the add-in twice. Uninstall both and reinstall once. The ribbon showing two IQ Tools panels is the symptom.

The Sync Review model

IQ Tools never writes to the model as you type. This is not Revit's Synchronize with Central: an IQ Tools sync writes to your local model as one transaction, and you synchronize with central as usual afterwards. It follows four stations:

  1. Read. The model is read out-of-process over a local named pipe. Reads never modify the document.
  2. Cache. What was read lives in a local SQLite file. The grid, filters, grouping, censuses and exports all run against that cache, which is why they answer in milliseconds.
  3. Stage. An edit in the grid or the inspector is held in the cache and shown as pending. Revit has not changed.
  4. Sync Review. Sync shows you the exact batch: every element, every parameter, old value and new value. Approve it and the batch lands in Revit as one transaction. A cell Revit refuses is reported against that cell with the reason, and the rest of the batch still lands.

This is deliberate friction. The time study prices it at roughly 6–11 hours a year. It is what lets you catch a bad bulk edit before it touches 136 doors.

Worksharing

  • Before writing, each element in the batch is checked against Revit's live checkout state. An element checked out by a colleague is refused with their name against that row ("Checked out by …"); pinned and deleted elements are refused with their reason. The remaining rows commit.
  • Refusals are listed per row after the sync, so you can see exactly which edits did not land and why, and re-sync them once the element is released.
  • IQ Tools does not borrow, check out, or relinquish elements on your behalf, and it does not call Synchronize with Central — you still SWC in Revit in the normal way.

Undo

  • A sync is one Revit transaction, so one Ctrl+Z in Revit reverses the whole batch. The one exception: if Revit rejects a grouped-element edit at commit time, the batch is split and the retried rows land as their own transactions, which adds an undo step for those rows only.
  • Every sync is recorded: which elements and parameters were written, the old and new values, who committed it and when. The history is kept with the project cache (the per-project database under %LOCALAPPDATA%\IQData\db\), so a director's question after a bad batch, "what changed, and who approved it", has an answer.

Read-only cells

  • Any cell that cannot be edited is greyed, and double-clicking it states why: a computed value, a workset checkout, or a restriction Revit imposes. Type parameters ARE editable — one edit is written to the type and applies to every instance of it, which the confirmation dialog states before you commit. On Revit 2026, parameters that Autodesk made read-only on a sheet show as read-only for that reason.

What it will not do

  • Edit geometry, place elements, or compose views. Geometry is Revit's job.
  • List elements from linked Revit models in the grid. The grid shows the open model only — see Does it work across linked models? below.
  • Write to the model while a Sync Review is open somewhere else. One batch at a time.
  • Discard staged edits on a licence event. An expired paid licence keeps a 14-day sync window. A lapsed trial keeps staged edits and syncs after purchase.

Does it work across linked models?

Today, no: the grid lists elements of the open model only. Elements inside linked Revit models are not listed, filtered, or editable in the grid — open the linked model directly in Revit (or as its own host model in IQ Tools) to work with its data.

This is a current limitation rather than a permanent one; support for elements in linked models is not yet scheduled, and no date is promised.

Where native Revit closes the gap

Several workflows on this site are honestly priced against a native baseline that a newer Revit release, or a different native path, narrows. This table collects those admissions in one place.

WorkflowNative path that closes the gap
Workflow 03 · Sequential renumberingRevit 2027's rule-based numbering templates largely solve this natively; on 2027 the workflow's advantage drops to near zero.
Workflow 07 · DWG links auditRevit 2026's Manage Links redesign narrows this workflow by an estimated 20–25%.
Workflow 02 · Bulk parameter editThe Properties palette (multi-select, set the field once, Apply) is close to parity for one uniform value — IQ Tools wins by roughly half a second on 50 elements. See the study, rev D.
Workflow 06 · Sheet set updateFor one uniform value across a set, the Properties palette is faster than IQ Tools — by about 9% on 100 sheets, three fields. IQ Tools wins once the values differ per sheet or need review before they land. See the study, rev D.

Where your data lives

  • Model data is cached in a local SQLite file per project under %LOCALAPPDATA%\IQData\db\ (one .sqlite3 file per project). It is never uploaded. It is safe to delete; the next open rebuilds it.
  • Logs are written to %LOCALAPPDATA%\IQData\logs\ (the desktop app) and %LOCALAPPDATA%\IQData\addin\logs\ (the Revit add-in). They contain element IDs, parameter names and timings, not model geometry. Support will ask for them.
  • Crash reporting and usage telemetry are opt-in. Nothing is collected unless you turn it on. If you opt in, a crash report carries the stack trace, the IQ Tools and Revit versions and the operating system version, never model data; usage telemetry carries feature counts, never model data. The switch is at %LOCALAPPDATA%\IQData\ (small JSON preference files). See Privacy.
  • Licence checks send the licence identifier, a hashed machine identifier, the IQ Tools version, the Revit version and the Windows version to api.keygen.sh. Nothing about your models is included.

Licence, Revit versions & offline use

Two ways to buy

  • By card: up to 100 seats on the annual plan, or one seat monthly. A seat is bound to one Windows user on one machine and moves to a replacement machine when you email support, so it survives a laptop replacement.
  • On invoice or purchase order, for over 100 seats or when your practice pays that way: talk to sales. Seats are named: one person, one machine. When people move between projects, email support@iqtoolspro.com and we move the seat. A shared floating pool for occasional users is planned, but is not available today.

Every Revit version is included

  • Every seat runs on Revit 2024, 2025, 2026 and 2027. When Autodesk ships a new release it is added to the subscription; there is no separate upgrade to buy. Target availability after each Revit release: 8 weeks.
  • One installer carries every supported Revit version and installs for all of them by default, so a supported Revit version installed after IQ Tools finds the add-in already in place. The wizard (or the silent ADDLOCAL switch) lets IT limit the install to chosen versions. A Revit release newer than the installer needs the next IQ Tools release, which the subscription includes.

Offline, VDI and networks

  • The licence revalidates online periodically and tolerates 14 days without a connection, so a firewalled BIM workstation keeps working.
  • If a licence check is blocked (a proxy, a firewall rule, or an outage at either end), IQ Tools keeps working normally for 14 days from the last successful check. If it still can't connect, the grid stays readable and exportable and edits you've already made can still be synced for a further 14 days, but new edits pause. Everything resumes at the next licence check, or when you restart IQ Tools. Nothing is lost. A licence that has expired or been cancelled is a different case and takes effect immediately.
  • A re-imaged workstation is normally recognised as the same machine, so the seat carries over with no action. If it is not — a new laptop, a replaced motherboard — email support to free the old machine, then activate the new one. Non-persistent VDI pools (Citrix, AVD and similar) are not supported today, because every session looks like a new machine. Pooled licensing for non-persistent environments is planned.
  • Two outbound HTTPS connections on port 443, to api.keygen.sh and licence.iqtoolspro.com. Those are the only things to allowlist. The system proxy is honoured, including an authenticated corporate proxy using your Windows credentials. Nothing listens for inbound connections, and no certificate pinning is used, so a TLS-inspecting proxy will not break it.
  • Trial: 14 days, full product, no card. When it ends the grid stays readable and exportable; editing and Sync need a seat.

Deployment brief for IT

  • What it is: a Revit add-in (one .addin manifest per Revit version) plus a separate desktop process that runs beside Revit. The two talk over a local named pipe on the same machine. No service is installed, and nothing listens on the network.
  • Scope: per-machine, for all users (add-ins under %ProgramData%\Autodesk\Revit\Addins\<year>\, application under %ProgramFiles%\IQTools\IQData\). Installing needs administrator rights or SYSTEM (SCCM, Intune, GPO).
  • Silent install: msiexec /i IQTools-PerMachine-1.0.0.msi /qn, with ADDLOCAL to choose Revit versions. Signed by IQ Tools (Authenticode, Azure Artifact Signing).
  • Data: a per-project SQLite cache and a log file, both local (paths above). No model data leaves the machine. Crash reporting and telemetry are opt-in and off by default.
  • Network: none needed to run. The only outbound calls are the periodic licence checks to api.keygen.sh and licence.iqtoolspro.com, HTTPS/443, system + authenticated proxy honoured, a 14-day offline tolerance, after which new edits pause until the next successful licence check (see above).
  • Uninstall: standard Windows uninstall or msiexec /x; removes the add-in manifests, the application and the per-project caches. Models are untouched.
  • Revit versions: 2024, 2025, 2026 and 2027.

Changelog

VersionDateRevitChanges
1.0.0at release2024–2027First public release.