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

# Setting Up MH Tags

> Choose once, for the whole project, which Acelab product data your tags carry and show.

MH Tags are Revit Generic Annotation tags made from your Acelab products. They let you tag drafted work, such as finish plans, FF\&E and ceiling plans, where there is no modelled element to link. You set them up once per project on the **MH Tags** tab in Settings. After that, placing a tag is one click from the Acelab panel.

### Before you start

* MH Tags are part of **AECO Pro**. Without it, the **MH Tags** tab is greyed out.
* Your model is linked to an Acelab project.
* You know where your Shared Parameters file is (the same `.txt` file as **Manage → Shared Parameters** in Revit). If you don't have one, choose a location and the add-in creates the parameters for you.

### Step 1: Open the MH Tags tab

1. On the **Acelab** tab, click **Settings**, or click the gear icon in the Acelab panel.
2. Click the **MH Tags** tab.

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

### Step 2: Set the Shared Parameters file

Under **Shared Parameters File Location**, click **Browse** and pick your Shared Parameters `.txt` file.

### Step 3: Choose how tag types are named

Each product gets its own tag type. In **Type naming pattern**, combine these tokens with any text you like:

* `{Manufacturer}`
* `{Product Name}`
* `{Type Mark}`

The default is `{Manufacturer} {Product Name}`. The example below the box shows how a real product from your schedule will be named.

### Step 4: Choose the fields every tag carries

Under **Parameters in every MH tag**, each Acelab field has a toggle and an eye:

* **Toggle on**: the field is carried by every tag as a type parameter named **MH\_***FieldName*, so you can schedule and export it. The field shows **Active**.
* **Eye open**: the field's value is also drawn on the tag face. Click the eye again to hide it from the face but keep carrying it.

Fields are grouped as **Product**, **Project Data**, **Company Data**, **Special Company Data**, **Revit Data** and **Product Data**. Use the search box to find a field. The summary line counts how many type parameters, instance parameters and drawn lines you have.

Keep in mind:

* **Manufacturer** and **Product Name** are always carried. You can only hide them from the tag face with the eye.
* **Revit Data** lists only fields that sync both ways, such as Revit Type Mark, Revit Description, Revit Cost and Revit Keynote. Values like area and count are not available on tags.
* A tag draws up to **10 lines**, in the order the fields are listed. There's no limit on how many fields a tag carries. The limit is only on what the label shows: if more than 10 eyes are open, the tab tells you, and the label draws the first 10.

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

### Step 5 (optional): Add your own instance parameters

Instance parameters hold values you type per tag in Revit, such as a room name or a note. Acelab never writes them, and sync never changes them.

1. Under **Instance parameters (optional)**, click **Add instance parameter**.
2. Enter a **Parameter name** and, if you want, a **Default value**.
3. Click the eye under **On tag** to draw it on the tag face. You can add as many instance parameters as you need. The label shows up to 5 of them.

Click **Remove** to delete one.

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

### Step 6: Choose the tag style

Under **Symbol**:

| Setting | What it does | Default |
| :- | :- | :- |
| **Boxed symbol** | Draws a border around the tag text | On |
| **Leader line** | Places new tags with a leader | On |
| **Leader arrowhead** | The arrowhead used on new tags, from your project's arrowhead types | None |

**Note:** Leader settings apply to tags you place from now on. Tags already on your drawings keep their leaders. **Boxed symbol** is set when the tag family is first added to the project.

### Step 7: Save

1. Click **Save & Sync**.
2. If you turned fields on or off, the **Load New Tag Parameters** window lists them:
   * **New Fields will be added to your Shared Parameters file**: fields turned on that the file doesn't have yet
     * **Already in file, it will be loaded into this project**: fields turned on that the file already has
   * **These fields will be turned off and will no longer sync**: fields you turned off
3. Check the lists and click **Append & Load**. Click **Cancel** to go back without saving.
4. Settings closes and a sync runs. Every MH tag type in the project is updated to your new settings.

### What happens next

* You can now place tags from the Acelab panel. See Placing MH Tags on Drawings.
* Settings are saved in this Revit project. Other projects keep their own MH Tags settings.

### Troubleshooting

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

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

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

  <tbody>
    <tr>
      <td>**MH tags are available on AECO Pro.**</td>
      <td>Your project needs AECO Pro. [See plans](https://acelabusa.com/pricing/architects-owners)</td>
    </tr>

    <tr>
      <td>**The type naming pattern must contain at least one token.**</td>
      <td>Add at least one token, such as `{Product Name}`</td>
    </tr>

    <tr>
      <td>**\{X} is not a naming token.**</td>
      <td>Use only the four tokens listed above</td>
    </tr>

    <tr>
      <td>**Every instance parameter needs a name.** / **Two instance parameters cannot share a name.**</td>
      <td>Name every instance parameter, and give each a different name</td>
    </tr>

    <tr>
      <td>**Tag is full**</td>
      <td>A tag draws up to 5 instance parameters. Close the eye on another one first</td>
    </tr>

    <tr>
      <td>**Invalid File: This file does not have write permission.**</td>
      <td>Pick a Shared Parameters file you can edit, or ask IT for access</td>
    </tr>

    <tr>
      <td>**Revit could not read the shared parameters file.**</td>
      <td>The file is empty or not a Shared Parameters file. Pick another file</td>
    </tr>

    <tr>
      <td>**Failed to load the shared parameters.**</td>
      <td>**Append & Load** didn't finish. Try again, or click **Report Error** to send the details to Acelab</td>
    </tr>

    <tr>
      <td>**Close the MH Tags family in Revit and try again.**</td>
      <td>Close the MH\_Tags family if you have it open in the Family Editor</td>
    </tr>

    <tr>
      <td>**Close the open Revit command and try again.**</td>
      <td>Press Esc to end the current Revit command, then save again</td>
    </tr>
  </tbody>
</table>

### Related articles

* [Placing MH Tags on Drawings](https://docs.acelabusa.com/help-center/revit-integration/placing-mh-tags-on-drawings.md)
* [How MH Tags Stay in Sync](https://docs.acelabusa.com/help-center/revit-integration/how-mh-tags-stay-in-sync.md)
* [Sync Material Hub Fields into Revit as Shared Parameters](https://docs.acelabusa.com/help-center/revit-integration/sync-material-hub-fields-into-revit-as-shared-parameters.md)
