Choose which Material Hub fields sync into your Revit project as Custom Shared Parameters, so your Acelab data lives natively on Revit elements and materials.
PRO feature. Configuring MH Fields is available to PRO users. Non-PRO users can see the MH Fields tab but cannot edit it.
Before You Begin
The Acelab Revit plugin must be installed. See Installing and Uninstalling the Revit Plugin.
Your Material Hub project must be linked to your Revit project. See Linking and Unlinking Material Hub Projects to Revit.
You need a Shared Parameter (
.txt) file for the project. Acelab writes new parameters to this file, so make sure you have write access to it.
How It Works
You pick which Material Hub fields to sync from the MH Fields tab in Settings. When you save, Acelab writes those fields into your Shared Parameter file and loads them into your Revit project. From then on, every sync writes your current Acelab field values onto the linked Revit elements and materials.
Acelab is the source of truth. Each sync overwrites Revit with whatever Acelab currently holds. If a value is cleared in Acelab, the matching Revit parameter is blanked - Revit never keeps a stale value.
Open the MH Fields Tab
Open the Acelab plugin in Revit and click Settings.
The Settings modal opens with two tabs at the top: Revit Fields (the default) and MH Fields.
Click the MH Fields tab.
PRO users: the tab is fully interactive — file path input, field groups, and toggles are all active, and the Save button is enabled.
Non-PRO users: a PRO badge (lock icon) appears next to the tab label. All content is visible but grayed out, and Save is disabled.
Switching between tabs never closes or reloads the modal. Any unsaved MH Fields changes are kept until you click Save or Cancel.
Set Your Shared Parameter File
At the top of the tab, the Shared Custom Parameters File Location shows the current file path.
Click Browse to open a file picker.
Select the
.txtShared Parameter file you want Acelab to use.The path in the input updates to your selection.
Acelab checks the path each time you save. If it's missing or invalid, you'll see: "Invalid Path: Browse to select where your Shared Parameters file should be saved."
Choose Fields to Sync
Under Choose fields to sync from Material Hub, fields are organized into four collapsible groups:
Project Data
Company Data
Product Data
Special Company Field Data
Each group is collapsed by default. Click a group row to expand it and see the fields inside.
Toggle fields on or off
Group toggle — turns every field in the group on or off at once. The group toggle shows as on only when all its fields are on.
Individual field toggle — turns a single field on or off.
Each field row shows a toggle, the field name, a data type icon (≡ for text, # for number), and a status:
Status | What it means |
Not enabled | Field is off and won't sync. No Revit parameter name is shown. |
New | Field is being enabled for the first time. Shows its Revit parameter name ( |
Active | Field was enabled in a prior session and is already loaded in your project. Shows its Revit parameter name. |
Toggle changes apply immediately in the tab — you don't need to save to expand groups or flip toggles. Nothing is written to Revit until you save.
Save Your Settings
Click Save when you're done.
No new fields to add?
Your settings save directly.
New fields pending?
The Load New MH Parameters confirmation appears first, showing what will change:
New Fields will be added to your Shared Parameters file — fields written to the
.txtfile for the first time.Already in file — will be loaded into this project — fields that exist in the file but haven't been loaded into this Revit project yet.
Review the lists, then:
Click Cancel to close without saving. Your toggle choices are kept.
Click Append & Load to write the new parameters to your file, load them into the project, and save.
If a field needs to be written but the .txt file isn't writable, the file path appears in the confirmation with an error status. Fix write access to that file and try again.
On success, a confirmation appears and the Settings modal stays open in a success state. Close or cancel the modal when you're ready.
What Happens on Sync
Once your fields are enabled, run a sync as usual from the Acelab tab. MH field sync runs as an extra step within your normal sync.
For each enabled field, Acelab writes the current Acelab value to the MH_[FieldName] Shared Parameter:
On linked Revit elements as a Type parameter.
On the corresponding Revit materials as an Instance parameter.
Notes on sync behavior:
Cleared in Acelab → the Revit parameter is blanked.
Disabled fields → skipped entirely, no read or write.
A parameter that hasn't been loaded into the project → silently skipped (no error).
Elements with no linked Acelab record → left untouched.
Viewing Synced Fields in Revit
On an element: select it, click Edit Type, and look under Data in the Type Properties window for the
MH_parameters.On a material: open the Material Browser, select the material, and check the Identity tab.
Good to Know
Disabling a field doesn't remove it from your file. Turning a field off soft-deletes its configuration so it stops syncing, but the parameter definition stays in the
.txtfile and remains bound in the project.Settings are per project. Field choices in one project don't affect any other project.
The Revit Data group isn't included in MH Fields sync.