Shared vs project parameters in Revit: which one to use and when

Share

Revit has four kinds of parameters, and picking the wrong one is a classic source of empty tags and schedules that cannot be reused. This guide sums up what Autodesk’s Revit 2027 help says about each type and how to set them up.

The four parameter types

  • Project parameters live in one project file. You assign them to categories of elements, sheets or views, and use them in schedules, sorting and filtering. Autodesk notes they “cannot be shared with other projects”.
  • Shared parameters are definitions stored in a separate text file, outside any project or family. They can be used in multiple families and projects, and because the definition is protected from change, they can be tagged and scheduled.
  • Family parameters control values inside a family, such as dimensions or materials, and stay specific to that family.
  • Global parameters belong to one project but are not assigned to categories. They drive or report values, for example a dimension tied to an equation.

The rule that settles most cases

Autodesk’s help is explicit: “In order for information in a parameter to be used in a tag, it must be a shared parameter.” If a value must appear in a tag, or in a schedule fed by families from different sources, use a shared parameter, loaded in both the element family (or project) and the tag family.

Use a plain project parameter when the data only matters in one project and will only be scheduled or filtered, never tagged. Use a shared project parameter when you want the project-level convenience plus tagging and reuse.

How to create a shared parameter

  1. Go to Manage tab, Settings panel, Shared Parameters.
  2. Click Create for a new file, or Browse to your office file.
  3. Under Groups, click New and name the group.
  4. Under Parameters, click New and set the name, discipline and type (Text, Length, Yes/No and so on).
  5. Add an optional tooltip of up to 250 characters, then click OK.

You do not choose instance or type here. That choice comes later, when the parameter is added to a family or project.

How to add a project parameter

  1. Go to Manage tab, Settings panel, Project Parameters, then click Add.
  2. Choose Project parameter, or Shared parameter to pick one from the active file.
  3. Enter a name, discipline and type. Autodesk advises: “Do not use a dash (-) in parameter names.”
  4. Pick the Properties palette group, then Instance or Type.
  5. Select the categories it applies to and click OK.

Pitfalls to avoid

  • A Revit session reads only one shared parameter file at a time. Keep a single office file in a shared network location rather than several local copies.
  • Existing shared parameters cannot be renamed or change type. Plan names carefully; you can only move them to another group or delete them.
  • Empty a group before deleting it.
  • Two shared parameters with the same name but different definitions will not behave as one. Always pick from the office file instead of recreating a parameter.

Source

Get the Revit news that matters

AI, releases, add-ins and API updates for Revit users. One short email, no spam, unsubscribe anytime.

Editor of revit.news and founder of HEXABIM. 25 years in civil engineering and digital modelling. Articles are prepared with the help of automated tools from linked public sources and published under his editorial responsibility.

Get the Revit news that matters

AI, releases, add-ins and API updates for Revit users. One short email, no spam, unsubscribe anytime.

Read more

Latest Revit news