01 / 21

Shared Parameters
in Autodesk Revit

Learn how to create and add shared parameters to families for consistent scheduling and tagging across your entire Revit project.

Autodesk Revit

What Are Parameters in Revit?

Parameters are data containers attached to Revit elements. They store information like dimensions, materials, costs, and custom data. Every door, wall, or window in your project holds parameters that define its properties.

Type Parameters
Shared by all instances of a family type: e.g., default width of a door type.
Instance Parameters
Unique to each placed element: e.g., the specific room number a door connects to.

Three Categories of Parameters

Family Visible only inside the Family Editor Cannot schedule or tag Project Added at the project level to categories Can schedule, cannot tag Shared Defined in external file, used everywhere Can schedule AND tag Capability Comparison Schedule: ✕ Tag: ✕ Schedule: ✓ Tag: ✕ Schedule: ✓ Tag: ✓

Why Shared Parameters Matter

Imagine your firm designs hundreds of custom furniture families. A client asks: "Can I see a schedule of all furniture with fire ratings?" Without shared parameters, that custom data is locked inside each family and invisible to schedules and tags.

Consistency
The same parameter definition is reused across every family: same name, same data type, same GUID.
Scheduling
Shared parameters appear as schedulable fields, letting you build custom schedules with your own data.
Tagging
Create annotation tags that read shared parameter values: automatically labeling elements on sheets.

The Shared Parameter File

SharedParams.txt External definition file Group: Mechanical CFM, BTU, Pressure Group: Identity Fire Rating, Asset ID Family A Door.rfa Family B Window.rfa Project Schedule / Tag

The Golden Rule of Shared Parameters

1
Define the parameter in the shared parameter .txt file (name, group, data type).
2
Add the parameter to each relevant family using the Family Editor.
3
Load the updated families into your project: the parameter is now schedulable and taggable.

Shared vs. Project Parameters

Shared Parameter Project Parameter
Storage External .txt file Inside the project (.rvt)
Schedulable ✓ Yes ✓ Yes
Taggable ✓ Yes ✕ No
Cross-project ✓ Portable ✕ Project only
Setup effort More steps Fewer steps
Best for Office standards, tagging Quick project-specific data

Step-by-Step: Adding a Shared Parameter

1
Open the Shared Parameter file: Manage tab → Shared Parameters → Create or browse to your .txt file.
2
Create a Group: Click "New Group" to organize parameters (e.g., "Identity Data", "Mechanical").
3
Create the Parameter: Click "New Parameter", set name, discipline, and data type (Text, Number, Yes/No, etc.).
4
Open the Family Editor: Open your .rfa family file in Revit.
5
Add to Family: Family Types → Add Parameter → choose "Shared parameter" → select from file → set Type or Instance.
6
Load into Project: Load the updated family → the parameter now appears in schedules and can be tagged.

Example 1: Fire Rating Parameter

Scenario: Your firm needs every door family to display its fire rating in both schedules and annotation tags on construction documents.

SharedParams.txt "Fire Rating" (Text) Door Family (.rfa) Add as Type param Project Load family Door Schedule Door-101 | 20 min Door-102 | 60 min Door-103 | 90 min Door Tag (on sheet) 60 min

Example 2: Asset ID for Equipment

Scenario: A facilities manager wants every piece of mechanical equipment tagged with a unique Asset ID for maintenance tracking. Each physical unit gets its own ID.

1
Define "Asset_ID" in shared parameter file: Group = "Identity Data", Type = Text.
2
Open each equipment family (.rfa) and add "Asset_ID" as an Instance parameter (each placed unit gets a unique value).
3
Create a tag family that reads "Asset_ID" using a label pointing to the shared parameter.
4
Load both families into the project. Place equipment, fill in Asset IDs, and tag: the tags auto-display each unit's ID.

Example 3: Building a Tag Family

A tag family in Revit is an annotation that reads parameter values from elements it tags. To display a shared parameter in a tag, the tag family must reference that exact shared parameter.

1
File → New → Family: choose a tag template (e.g., "Generic Tag.rft" or "Door Tag.rft").
2
Place a Label in the tag using the "Label" tool from the ribbon.
3
In the Edit Label dialog, click "Add Parameter" → choose the shared parameter from your .txt file (e.g., "Fire Rating").
4
Save and load the tag family into your project. Tag elements: the shared parameter value appears automatically.

The GUID Connection

Every shared parameter has a GUID (Globally Unique Identifier): a unique code that Revit uses to match parameters across families and projects. This is what makes shared parameters "shared".

GUID: a3b2c1d4-e5f6-7890-abcd-ef1234567890 Door.rfa "Fire Rating" Window.rfa "Fire Rating" DoorTag.rfa "Fire Rating" Same GUID = Same Parameter = Data Flows

Type vs. Instance: Choosing Wisely

When adding a shared parameter to a family, you must choose whether it is a Type or Instance parameter. This decision affects how data is entered and displayed.

Type Parameter
One value per family type. Change it once, all instances update. Best for: Fire Rating, Material Grade, Manufacturer.
Instance Parameter
Unique value per placed element. Each instance can differ. Best for: Asset ID, Room Association, Installation Date.

Organizing Parameter Groups

Inside the shared parameter file, parameters are organized into groups. These groups help you find parameters quickly when adding them to families. They also help maintain office standards across large teams.

Identity Data
Fire Rating, Asset ID, Warranty Info, Model Number
Mechanical
CFM, Static Pressure, BTU Rating
Electrical
Circuit Number, Voltage, Connected Load

Common Mistakes to Avoid

✕ Duplicate Names
Creating parameters with the same name but from different shared files: they have different GUIDs and will not link in schedules or tags.
✕ Wrong Type vs. Instance
Setting "Asset ID" as a Type parameter means all instances share one ID: defeating the purpose of unique identification.
✕ Lost Shared File
If the .txt file is deleted or moved, you cannot add the parameter to new families. Always store it in a shared network location.

Summary: Parameter Types at a Glance

Feature Family Project Shared
Defined in Family Editor Project External .txt file
Visible in project ✕ ✓ ✓
Schedulable ✕ ✓ ✓
Taggable ✕ ✕ ✓
Cross-project ✕ ✕ ✓
Setup effort Minimal Low Moderate

Question 1 of 5

Which type of parameter in Revit can be used in both schedules and tags?

Question 2 of 5

Where are shared parameter definitions stored?

Question 3 of 5

An "Asset ID" that must be unique for every placed element should be added to a family as which kind of parameter?

Question 4 of 5

You created a "Fire Rating" parameter in two separate families by typing the name manually instead of using the shared parameter file. What will happen?

Question 5 of 5

What is the correct order for implementing a shared parameter that appears in a tag?