Installing and licensing BA.TIVA Revit plugins

System requirements

To check your Revit version and update, click ? at the top right of Revit, then About Autodesk Revit.

Privacy: licensing sends only your account, device and licence details to BA.TIVA. Nothing about your model or project ever leaves your PC.

Step 1: Download and unblock the installer

Close Revit before you start: the installer waits until Revit is closed.

1. Sign in at bativahq.com and open the page of the tool you want, for example Grid & Level Guard or Room Data Auditor, or Account → Downloads. Tick the box to accept the Terms of Service, then click Download installer. The file is named BATIVA-for-Revit-<version>-Setup.exe.
2. Open your Downloads folder, right-click the file and choose Properties.
3. On the General tab, tick Unblock at the bottom, then click OK.

If you don't see an Unblock box, Windows hasn't flagged the file. Go straight to Step 3.

Step 2: If Windows shows “Windows protected your PC”

This window is Microsoft Defender SmartScreen. It appears for new software that Windows hasn't seen many times yet. It doesn't mean the file is harmful.

1. Click More info.
2. Check that the app is BATIVA-for-Revit-<version>-Setup.exe. The publisher shows as “Unknown publisher” until BA.TIVA's installer is code-signed.
3. Click Run anyway.

If there is no Run anyway button, your company has locked this setting. Ask your IT team to install the plugin for you (see For IT departments).

Step 3: Run the installer

1. Choose Install for me only (recommended). This needs no administrator rights. Choose Install for all users only if you're an administrator setting up a shared PC.
2. If you chose all users, Windows asks “Do you want to allow this app to make changes to your device?” Click Yes.
3. On the Ready to Install screen, click Install.
4. When setup says it has finished, click Finish.

Every BA.TIVA tool in the installer is installed for every supported Revit version on your PC, so there's nothing to choose: your licence, not the installer, decides which tools you can use. If an earlier copy of a BA.TIVA tool is installed, such as a stand-alone installer or a tester build, the installer removes it first so Revit doesn't load it twice.

Step 4: Open Revit, allow the tool and sign in

Open Revit. The first time each BA.TIVA tool loads, Revit may show a Security – Unsigned Add-In window. Revit asks once for each tool.

1. Check that the window names a BA.TIVA tool, such as Grid & Level Guard or Room Data Auditor.
2. Click Always Load so Revit doesn't ask again. Load Once also works, but Revit will ask every time it starts.
3. Open a project, open the BA.TIVA tab on the Revit ribbon and click the tool. In the panel that opens, click Sign in.
4. Your web browser opens at bativahq.com. Sign in with your BA.TIVA account, then return to Revit.
5. Click Start 14-day trial for a 14-day free trial, or carry on if you already have a subscription.

Licensing explains the licence bar and every message on it. To learn a tool itself, read the Grid & Level Guard or Room Data Auditor user manual.

Updating

Close Revit and run the newer BA.TIVA for Revit Setup. It replaces the older version in place, so you don't need to uninstall first. If a newer version is already installed, it says so and closes.

Updating never touches your projects: Grid & Level Guard's baselines stay where they are, and Room Data Auditor saves nothing in projects.

Uninstalling

1. Close Revit.
2. Open Windows Settings → Apps → Installed apps.
3. Find BA.TIVA for Revit and click Uninstall.

This removes every BA.TIVA tool. Grid & Level Guard baselines saved in your projects stay in place, and so do your sign-in and logs in %LOCALAPPDATA%\BATIVA.

For IT departments

• Publisher: BATIVA Creative Ventures Limited, bativahq.com.
• What it installs: one Autodesk application bundle, BATIVA.bundle, which Revit loads at start-up through its PackageContents.xml.
  • Per user (no admin rights): %APPDATA%\Autodesk\ApplicationPlugins\BATIVA.bundle
  • All users (admin): %ProgramData%\Autodesk\ApplicationPlugins\BATIVA.bundle
• Silent install: BATIVA-for-Revit-<version>-Setup.exe /VERYSILENT for the current user, or /VERYSILENT /ALLUSERS run as an administrator.
• Network access: HTTPS to bativahq.com for sign-in and licence checks, about once a day. Sign-in opens the system browser and returns through a local address on 127.0.0.1. The tools work offline for up to 30 days.
• Settings and logs: %LOCALAPPDATA%\BATIVA. The installer writes a log to %TEMP% named Setup Log <date>.txt.
• Code signing: the installer isn't code-signed yet, so Windows SmartScreen and Revit both warn on first use. Check the download against its SHA-256 checksum, also shown under Release notes and checksum beside the Download button:
  • Version 1.0.0 (Grid & Level Guard 1.0): ab8da3a5760d2477757d3e1985953e149f6845d6b3e1bc3a1b6e76fb50b7c9ac
  • Version 1.1.0 (Grid & Level Guard 1.0 and Room Data Auditor 1.0.1): cd5413cc8a2a35f2659fe77a45e2a4056ddc7698d10401876bfd57a67bfe412b
  • Version 1.2.0 (Grid & Level Guard 1.0.1, Room Data Auditor 1.0.1 and Model Cleanup 0.1.0): 8415b082d30c1d45ff1222705c5d0342f797cd622be7882aee0fb4c6a059777e

Licensing

You sign in with your BA.TIVA account, then use a 14-day free trial or a subscription for each tool. There are no licence keys, and the trial needs no card. Each tool shows your licence in the licence bar at the top of its panel.

Sign in and start your trial

1. Open the tool's panel. The licence bar says, for example, Sign in with your BA.TIVA account to use Room Data Auditor. The tool's main buttons are switched off until you have a licence.
2. Click Sign in. Your web browser opens at bativahq.com. Sign in, or create an account there. When the page says You're signed in to BA.TIVA, return to Revit. You have 5 minutes to finish.
3. Click Start 14-day trial. The licence bar now says Trial: 14 days left.

• One sign-in for every tool. You sign in once on each computer. Every BA.TIVA tool, in every Revit version on that computer, shares the sign-in.
• Each tool has its own trial, once per account and once per computer. A trial starts only when you click Start 14-day trial, not when you sign in.
• You can also start a trial on the tool's page at bativahq.com: click Start 14-day trial. No card is needed.

Subscribe

1. Click Subscribe in the licence bar, or open the tool's page on bativahq.com.
2. Under Billing, choose Monthly or Annual. Annual shows how much you save.
3. Under Pay by, choose Card (renews automatically) or, where offered, Direct bank transfer (you pay for each period yourself).
4. Click Subscribe and complete the payment.
5. Return to Revit. The licence bar updates by itself within about a minute, or click Check again.

When it worked, the licence bar says Subscribed. Renews <date>. If you pay by bank transfer, the subscription starts when your transfer is confirmed, the licence bar says Subscribed until <date>., and from 7 days before each period ends your account asks you to pay for the next one.

• Subscribing during your trial doesn't cut it short: the trial carries on, and the paid period and the first charge start when it ends.
• Cancel any time from your account, and keep access to the end of the period you've paid for. Manage your plan and payment card there too.
• The 14-day refund policy in the Terms of Service applies to a subscription's first paid period.
• If a renewal payment fails, the licence bar says Payment failed. Update your card by <date> … You have 7 days' grace: click Update card, then Check again.

Devices and working offline

• 3 computers per person. All the Revit versions and BA.TIVA tools on one computer count as one. The same PC used under another Windows user counts as another computer. To move to a new computer, deactivate an old one under Manage devices, then click Check again on the new one.
• Offline for up to 30 days. The tools check your licence when Revit starts and about once a day. Between checks they work offline. If you stay offline, the licence bar warns you 7 days before it needs to connect.
• Sign out (in the licence bar, beside your account) signs this computer out of every BA.TIVA tool. The computer stays registered as one of your devices until you deactivate it on the website.

When the licence is not active

The panel still opens, the licence bar turns amber and says why, and its button says what to do. Nothing about licensing changes your model.

• Grid & Level Guard: Establish Baseline, Scan Model, Accept change, Reject change, Select in Revit and Export PDF Report are switched off, and Next step says what to click. Baselines saved in your projects are never changed or removed.
• Room Data Auditor: Scan Model, Select in Revit and Export PDF Report are greyed out; hovering over one shows Needs a licence: see the licence bar above. Results already in the panel stay there.

Licence messages

Each message names the tool, shown here as <tool>, and dates show in the form 21 Oct 2027. The tool works in the first five rows. In the rest, do what the last column says.

A second line may appear under the message as a warning while the tool still works, for example Your <tool> trial ends on <date>. Subscribe to keep using it. (3 days before the end) or Connect to the internet by <date> to keep using <tool>.

Troubleshooting