> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acelabusa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Linking Products to Revit Elements from the Acelab Panel

> Select something in your model, then link it to an Acelab product with one click.

The Acelab panel follows your Revit selection. You never need to search for the element you just clicked: select it, find the product, and click its link button.

### Before you start

* The Acelab panel is open and your model is linked to an Acelab project. See Using the Acelab Panel in Revit.
* Your Acelab project has products in its schedule.

**Good to know:** links are made on Revit **types** and **materials**, not on single instances. One type or material can link to one product. One product can link to many types and materials.

### Step 1: Select elements in Revit

Select one or more elements in the model, using any selection method. The panel updates on its own:

* Nothing selected: **No Revit Elements Selected.**
* One element: the type name, with its family below.
* Several elements: **Multiple Elements Selected**, with the number of elements below.

### Step 2: Choose what the link applies to

By default, a link applies to every type in your selection. To narrow it:

1. Click the scope dropdown in the selection box.
2. Under **Type**, pick one type. Rows read *Category | Type*, with the family underneath. A green tick marks the active choice.
3. To link a material instead, turn on **Show Materials**. A **Materials** section lists every material inside the selected types, as *Class | Material name*. Pick one.

To go back to all types, pick **All selected types**.

![Image](https://mintcdn.com/acelab/gL5TsBAyQCJ4leoZ/images/image-45.png?fit=max\&auto=format\&n=gL5TsBAyQCJ4leoZ\&q=85\&s=e3640a6280b908c1e23a8582158ea48b)

### Step 3: Check what is already linked

The **Linked Product** section shows each selected type or material next to the product it is linked to, or **No product**. Click the section header to collapse or expand it.

When more than three types or materials are in scope, the section shows a summary instead, such as **2 products linked** and the number of families, types and materials.

![Image](https://mintcdn.com/acelab/gL5TsBAyQCJ4leoZ/images/image-46.png?fit=max\&auto=format\&n=gL5TsBAyQCJ4leoZ\&q=85\&s=0ca8b2ab6769261f8661f02ed889f148)

### Step 4: Link a product

Find the product in the list (see Finding Products in the Acelab Panel), then click its **link button**, the first button on the row.

* If nothing was linked before, the product links straight away and the panel shows **Product linked**.
* If the type or material already has a different product, the panel asks **Replace linked product?** Click **Replace** to confirm.
* If several types or materials are in scope, the panel asks **Assign to N elements?** and lists any that already have a product and will be replaced. Click **Assign to all** to confirm.

Click **Cancel** on any of these to change nothing.

### What the link button shows

The link button shows the product's status for your current selection. Hover over it to see what a click will do, or click **ⓘ** in the **Product** column header to see this key in the panel.

| Button | Meaning | Click to |
| :- | :- | :- |
| Filled green | Linked to the selected element, or to all selected elements | Unlink it |
| Green outline | Linked to some of the selected elements | Link it to the rest |
| Green chain | Linked to another element in this model, not the selected one. The tooltip names up to four of them | Also link it to the selected element |
| Plain outline | Not linked to anything | Link it to the selected element |
| Dimmed | Nothing is selected in Revit | Select an element first |

![Image](https://mintcdn.com/acelab/gL5TsBAyQCJ4leoZ/images/image-47.png?fit=max\&auto=format\&n=gL5TsBAyQCJ4leoZ\&q=85\&s=066aae025c4e44998ab6af1efd19244e)

### Unlink a product

1. Select the element in Revit.
2. Click the filled green link button on its product, or the **×** next to the pairing in **Linked Product**.
3. The panel asks **Remove linked product?** Click **Remove**.

### Find a product's elements in the model

Hover over a product row and click the eye icon (**Highlight in view**). Revit selects every element linked to that product across the whole project, not only in the current view.

![Image](https://mintcdn.com/acelab/gL5TsBAyQCJ4leoZ/images/image-48.png?fit=max\&auto=format\&n=gL5TsBAyQCJ4leoZ\&q=85\&s=2d189593ca0e475fad6f1b17113d210f)

### Troubleshooting

<table>
  <colgroup>
    <col width="285" />

    <col width="427" />
  </colgroup>

  <thead>
    <tr>
      <th>What you see</th>
      <th>What to do</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>Every link button is dimmed</td>
      <td>Select an element in Revit first</td>
    </tr>

    <tr>
      <td>The panel ignores my selection</td>
      <td>MH Tags, rooms and annotations are not linkable, so the panel skips them. Select a modelled element</td>
    </tr>

    <tr>
      <td>No **Materials** section</td>
      <td>Turn on **Show Materials**. If it reads **The selected types carry no materials.**, link the type instead</td>
    </tr>

    <tr>
      <td>**Nothing was changed - the active model changed before this ran.**</td>
      <td>You switched models mid-click. Switch back and try again</td>
    </tr>

    <tr>
      <td>**Could not update the link.**</td>
      <td>Check that the model is not read-only and that you own the element if you work in a central model, then try again</td>
    </tr>

    <tr>
      <td>**This product doesn't have any elements linked**</td>
      <td>The product has no links yet, so there is nothing to highlight</td>
    </tr>

    <tr>
      <td>On Revit 2023 the panel takes a moment to follow the selection</td>
      <td>This is expected on 2023. Later versions update straight away</td>
    </tr>
  </tbody>
</table>

### Related articles

* [Using the Acelab Panel in Revit](https://docs.acelabusa.com/help-center/revit-integration/using-the-acelab-panel-in-revit.md)
* [Finding Products in the Acelab Panel](https://docs.acelabusa.com/help-center/revit-integration/finding-products-in-the-acelab-panel.md)
* [Mapping Acelab Products to Revit Elements](https://docs.acelabusa.com/help-center/revit-integration/mapping-acelab-products-to-revit-elements.md) (the **Map Assets** and **Map Products** windows still work)
* [Working with Central and Local Models in Revit](https://docs.acelabusa.com/help-center/revit-integration/working-with-central-and-local-models-in-revit.md)
