Skip to main content
Written by Patricia Causey · Updated March 20, 2026 Linking a project connects your Acelab product data to your Revit model. Once linked, you can map products to Revit assets, sync data, and keep your schedules up to date.
  1. Click Select Project in the ribbon the Acelab tab.
  2. From the dropdown menu, select the Acelab project -
    • The dropdown includes all projects you’ve created or been invited to in Acelab.
  3. Click Next.
  4. A confirmation message will appear indicating the project has been successfully linked. Click Close to dismiss it.
Tip: Make sure the products you need are already saved in your Acelab project before linking. This ensures they’re available for mapping once the connection is established.
An Acelab project can only be linked to one Revit Project at a time, and a Revit Project can only be linked to one Acelab project at a time. If either side already has an existing link, you’ll see a reassignment modal when you try to connect them. There are two scenarios where this can happen.

​
Scenario 1: The Acelab Project Is Already Linked to a Different Revit Project

If you select an Acelab project that is currently linked to another Revit project:
  1. Click Select Project in the top bar menu and choose the project you want to link.
  2. A modal will appear showing you which Revit project the selected acelab project is currently linked to.
  3. You have two options:
    • Reassign — Breaks the existing link between the project and the other Revit project, and links the Acelab project to your current Revit project instead.
    • Cancel — Keeps the existing link unchanged and returns you to the project dropdown.

​
Scenario 2: The Revit File Is Already Linked to an Acelab Project by Another User

If the Revit file you’re working in is already linked to an Acelab project that you don’t have access to:
  1. When you sign in and click on Select Project option in Acelab Ribbon, a modal will appear informing you that the Revit file is already linked to an Acelab project by another user.
  2. You have two options:
    • Reassign — Breaks the existing link and allows you to select a different Acelab project to link to this Revit file.
    • Cancel — Keeps the existing link in place. You won’t be able to map products and sync.
Important: Reassigning in either scenario removes all existing product-to-element mappings. You will need to remap your Acelab products to Revit elements after reassigning. Previously synced data (such as type parameter values) will remain in the Revit model, but those values will no longer update through Acelab. Tip: Coordinate with your team before reassigning. If another team member set up the link and mappings, reassigning will undo their work. Check with them first, or ask to be added as a collaborator on the linked Acelab project instead.
If you need to disconnect the current project or link a different one, you can do so directly from the Acelab tab in Revit.
  1. Click Select Project in the top bar menu.
  2. Click on Unlink Icon
  3. Click Unlink to confirm.
Note: Unlinking a project removes the connection between your Revit model and that Acelab project. Any previously synced data in Revit (such as type parameter values) will remain in the model, but no further syncs will occur until a new project is linked.
Once a project is linked, you can:

​
Troubleshooting