> ## 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.

# RevitAddIn Version 0.1.487

**Release:** Version 0.1.487 - November 16th 2026

**Includes:** Dockable Panel and MH Tags (Generic Annotation for drafted work)

### What’s new

This release introduces the **dockable panel** for mapping Acelab products to Revit elements. It works alongside the existing product mapping modal. It also adds **MH Tags**, which lets interiors teams place Acelab products on 2D drawings with live Acelab data.

***

### Dockable Panel

#### Panel and workspace

* Opens from the Acelab ribbon and docks on the right of the Revit workspace. It stays open across selections, view changes and commands.
* Header shows the bound Acelab project, with **Select Project, Sync, Settings and Close** controls.
* Drag the panel’s left edge to resize it. Width and open/closed state persist for the Revit session.
* Footer shows **Sync, last-sync time and Help Articles**.

#### Selection-driven mapping

* The panel reacts automatically to your Revit selection, with no extra clicks. Single selections show the element name and type. Multiple selections show the element count.
* **Scope selector:** narrow from the whole selection to one type, or to one material when **Show Materials** is on. Everything in the panel follows the chosen scope.
* **Linked Product section:** shows which Acelab product each selected element or material is linked to, one pairing per target, so a mixed selection shows exactly what carries what. A single pairing has an inline **Unlink** control. The section is collapsible.

#### Product list

* Your full Acelab project schedule is shown in a table with a pinned Product column (thumbnail, manufacturer, product name).
* Search, filters and sort work the same way as the existing mapping modal.
* **Pagination** keeps large schedules fast and light on Revit’s UI.
* Clear states for **loading, empty schedule, no search match and error (with Retry)**.
* **Manage Fields:** add product data fields as columns, grouped by Project Data, Company Data, Revit Data and Product Data. Includes search, a Filled-only toggle, a Reorder tab, resizable columns and horizontal scroll. Your configuration is saved per user.
* Field icons and badges match the Acelab platform, including bidirectional/unidirectional and Information/Decision indicators.

#### Linking

* A four-state **Link button** on every product row shows the state and performs the action: linked, partial, assigned elsewhere, or off.
* Assigning to an unlinked element is one click, with no confirmation.
* **Replace**, **Unassign** and **multi-element assign** are confirmed. A multi-element assign shows one confirmation listing what will be overwritten.
* Hover tooltips explain what each click will do.
* One element links to one product. One product can link to many elements.

#### Sync

* Sync pushes your Revit assignments to Acelab and pulls the current schedule. It is available from both the header and the footer.
* A banner tells you when the Acelab project has changed and offers a one-click Sync.
* The Syncing screen shows **live status text** describing what is happening.
* Search, filters, sort, columns, selection and scope are preserved across a sync.
* A failed sync keeps the previous list and your unpushed assignments, and shows a clear error.
* Sync performance has been improved, especially on projects with many linked records.

***

### MH Tags (Generic Annotation)

MH Tags are generic annotation tags created from Acelab products, so drafted-only work (finishes, FF\&E, wall protection, ceilings) can be tagged without a modelled host. They work on plans, sections, elevations, details, drafting views and sheets.

#### Settings: MH Tags tab

* A new tab in the Settings modal, available to **PRO users**. Non-PRO users see it locked with a PRO badge, and the tag button in the panel is disabled.
* **Family and Shared Parameters file:** choose the locations with Browse. Paths are validated on Save.
* **Type naming pattern:** build names from `{Manufacturer}`, `{Product Name}`, `{Model Number}` and `{Type Mark}`, with a live example.
* **Parameter catalog:** the same catalog as Manage Fields. Turn a field on to carry it on every tag as a type parameter, and use the **eye** to draw it on the tag face. Revit Data shows bidirectional fields only.
* **Instance parameters (optional):** add your own per-tag text parameters. Acelab never writes them, and Sync never touches them. They are grouped under **Others** in Revit.
* **Symbol style:** Boxed symbol, Leader line and Leader arrowhead. Arrowhead selection applies to tags on drawings and persists for newly placed tags.
* **Load New Tag Parameters** confirmation before new parameters are added.

#### Saving

* New parameters are added to your Shared Parameters file under the **Material Hub Parameters** group, using the `MH_[FieldName]` naming. If the same field already exists from MH Fields, the existing parameter is reused, so you never get duplicates.
* Parameters are loaded into the tag family.
* The full configuration (fields, visibility, naming, symbol style) is applied to **every tag type already in the project** in a single transaction, so all tags stay consistent.
* Settings are saved per project, and a success toast confirms it. Saving only redraws labels when label settings actually changed.

#### Placing tags

* Every product row has a **tag button** with a count of placed instances.
* One click creates the product’s tag type from your saved settings (if it doesn’t exist) and starts Revit’s placement command.
* The panel title shows “Placing Generic Annotation Tag”. Keep placing until you click the button again, click Finish or press Esc. Tags already placed stay on the drawing.
* Placing and exiting with Esc are smooth, including consecutive placements and switching between products.
* In 3D views you are prompted to switch to a 2D view.
* A placed tag is an ordinary Revit object. Use Revit’s Properties browser to see or edit its parameters.

#### Sync for tags

* Every Sync refreshes the type parameters of all placed tags from Acelab. Acelab is the source of truth, and a single update refreshes every instance of that product.
* Values cleared in Acelab are blanked on the tag.
* Products removed from the Acelab schedule keep their last values and can be flagged with a “Not in Acelab schedule” warning. Tags are never deleted automatically.
* Tag sync is an additional step. If no tags are loaded, sync behaves exactly as before.

***

### Quality and stability improvements

* Fixed a Revit crash when Save and Sync was clicked repeatedly. The button is now blocked while an operation runs.
* Fixed duplicate fields appearing on tag labels.
* Fixed Product and Manufacturer eye icons changing without user action, and the save error that blocked Boxed Symbol, Leader line and Leader arrowhead settings.
* Fixed instance parameter eye settings not saving, and values not showing on the label.
* Improved performance when selecting, placing and exiting tag placement.
* The loading state in Settings now blocks interaction with the parent window while data loads.

### Compatibility

* **Revit 2022 is no longer supported** in this release.

### Installer Instructions

Before installing, make sure to:

1. Uninstall the production version of the Acelab addin (from the typical windows settings)
2. Make sure there are no Acelab-related files left under `%appdata%\Autodesk\ApplicationPlugins` or `%programdata%\Autodesk\ApplicationPlugins`

### Files

[RevitAddin Version 0.1.487](https://acelab-api-prod-178528813198.us-east4.run.app/api/v1/revit/addin/download?environment=production\&version=0.1.487)
