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

# How MH Tags Stay in Sync

> Every sync refreshes your tags from Acelab, and Revit fields can flow back the other way.

MH Tags stay tied to their Acelab product. Each time you sync, every tag type in the project is updated, so every placed tag of a product shows the same, current values.

### Before you start

MH Tags are set up and placed. See Setting Up MH Tags and Placing MH Tags on Drawings.

### What updates on every sync

Click **Sync** in the Acelab panel or on the **Acelab** Ribbon. For every product with a tag type, the sync:

* writes the latest Acelab values into the tag type, so every placed tag shows them
* writes the result for each Revit Data field onto the tag type, so the tag matches the model (see below)
* renames the tag type to match your **Type naming pattern**
* redraws placed tags as soon as it finishes
* leaves your own instance parameters alone

When it finishes, the panel shows how many tags were updated, for example **Sync complete - 12 MH tags updated from Acelab**.

### Which way each field flows

| Field | Direction | What happens if you edit it on the tag in Revit |
| :- | :- | :- |
| Acelab fields (**MH\_***FieldName*) | Always Acelab → Revit | The next sync overwrites your edit. Change the value in your Acelab schedule instead |
| **Revit Data** fields set to **Revit → Acelab** | Revit → Acelab | Your edit is sent to your Acelab schedule on the next sync |
| **Revit Data** fields set to **Acelab → Revit** | Acelab → Revit | The next sync overwrites your edit with the Acelab value |
| Your instance parameters | Revit only | Kept. Acelab never reads or writes them |

You set the direction of each Revit Data field (Revit Description, Revit Cost, Revit Type Mark, Revit Type Comment, Revit Material Mark, Revit Material Comment, Revit Keynote Tag and Text) on the **Revit Fields** tab in **Settings**. Keynote Tag and Keynote Text always share one direction.

### Edit a Revit Data value on a tag

1. Select a placed tag and click **Edit Type**.
2. Change the field, for example **Type Mark**, and click **OK**. Every tag of that product shows the new value.
3. Click **Sync**.

If the field is set to **Revit → Acelab** and the product is also linked to modelled elements, the sync makes the tag and the model match:

* If only the tag changed since the last sync, the tag's value is copied to the linked elements and sent to Acelab.
* If only the model changed, the model's value is copied onto the tag.
* If both changed, the model's value wins.
* If the field is empty on the tag, the tag picks up the model's value.

If the field is set to **Acelab → Revit**, the tag shows the Acelab value after every sync. When the Acelab value is empty, the field on the tag is cleared too.

**Example:** a door type and its tag both show Type Mark **D-01**. You change the tag to **D-04** and sync. With Type Mark set to **Revit → Acelab**, the door type becomes D-04 and Acelab is updated to D-04. With **Acelab → Revit**, the tag goes back to D-01.

**Note:** **Revit Cost** must be a number to be sent to Acelab. If you type anything else on a tag, it stays on the tag as you typed it, and Acelab gets the model's value instead.

### When a product leaves the Acelab schedule

Removing a product from your Acelab project schedule doesn't change anything in Revit straight away. On the next sync:

* every placed MH Tag of that product is deleted, on every view and sheet
* the product's tag type stays in the project under **Families → Annotation Symbols → MH\_Tags**, with all its values cleared

To bring the tags back, press **Ctrl+Z** right after the sync. Adding the product back to the schedule doesn't restore deleted tags. Place them again from the Acelab panel.

**Important:** before removing a product from the schedule, check where it is tagged. The tag button's badge in the Acelab panel shows how many tags of that product are placed.

### When you change MH Tags settings

Clicking **Save & Sync** on the **MH Tags** tab updates every tag type already in the project: which fields it carries, which lines it draws and how it is named. A newly turned-on field shows **Updating...** until the sync finishes.

### Troubleshooting

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

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

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

  <tbody>
    <tr>
      <td>My edit on a tag was replaced after syncing</td>
      <td>The field is an Acelab field, or a Revit Data field set to **Acelab → Revit**. Edit it in Acelab, or change its direction on the **Revit Fields** tab</td>
    </tr>

    <tr>
      <td>My edit on a tag was replaced by the model's value</td>
      <td>Both the tag and the linked model element changed since the last sync, so the model won. Edit one of them and sync again</td>
    </tr>

    <tr>
      <td>Tags disappeared after a sync</td>
      <td>Their product was removed from the Acelab schedule. Press **Ctrl+Z** to undo the sync, or add the product back and place new tags</td>
    </tr>

    <tr>
      <td>**The Acelab field catalog could not be loaded, so tags cannot be updated.**</td>
      <td>Check your connection and sync again</td>
    </tr>
  </tbody>
</table>

### Related articles

* [Setting Up MH Tags](https://docs.acelabusa.com/help-center/revit-integration/setting-up-mh-tags.md)
* [Placing MH Tags on Drawings](https://docs.acelabusa.com/help-center/revit-integration/placing-mh-tags-on-drawings.md)
* [Syncing Data Between Material Hub & Revit](https://docs.acelabusa.com/help-center/revit-integration/syncing-data-between-material-hub-revit.md)
* [Legend Feature Overview](https://docs.acelabusa.com/help-center/revit-integration/legend-feature-overview.md)
