Combine Parameters is a Revit Assistant extension that lets you combine multiple parameter values (and optional constant text) into a single target parameter for all selected elements. It is useful when you want to build readable names, codes, or descriptions from several existing parameters without doing manual copy–paste.
Examples:
- Combine
Level, Type Name, and a custom text into one "Combined Name" parameter.
- Build a
Mark or Code parameter from several other parameters.
- Create consistent labels for schedules and tags.
These settings appear when you configure the task in Assistant. They come from the CombineParametersArgs configuration.
-
Combine Parts
A list of parts that will be joined together to form the final text.
- Each entry can be:
- The name of a Revit parameter (for example:
Type Name, Level, Comments, or a shared parameter name).
- A constant text value, written inside double quotes, for example:
" - " (dash with spaces)"_A" (suffix)"Beam" (fixed word)
- Empty entries are ignored.
- If a parameter does not exist or is empty on an element, that part is skipped for that element.
-
Combine Parameter
The target parameter where the combined result is written for each selected element.
- Enter the name (or ID) of an existing, editable parameter.
- This parameter must exist on the selected elements.
- If the parameter is missing on an element, that element is skipped and an error is listed in the result.
-
Combine String
The separator text used between the parts when they are joined.
- Examples:
- → result like Level 01 - Beam - Steel_ → result like A_01_Concrete, → result like A, B, C
- If left empty, parts are combined with no separator.
When you run Combine Parameters on your selection in Revit, it:
- Reads your configuration (Combine Parts, Combine Parameter, Combine String).
- Checks that:
- An active Revit model is open.
- Combine Parameter is filled in.
- At least one valid Combine Parts entry exists.
- Takes the currently selected elements in Revit. If nothing is selected, it stops with an error.
- Starts a Revit transaction called "Combine Parameters".
- For each selected element:
- Goes through every item in Combine Parts:
- If the item is wrapped in quotes (for example
" - "), it uses that exact text (quotes removed).
- Otherwise, it treats the item as a parameter name/ID and reads the value from the element.
- Only non-empty values are kept.
- Joins the collected values using Combine String as the separator.
- Looks for the target Combine Parameter on the element.
- Writes the combined string into that target parameter.
- If the target parameter cannot be found or written, an error is recorded for that element.
- Commits the transaction. If commit fails, no changes are kept.
- Shows a summary with:
- Number of elements successfully processed.
- Number of errors and a list of per-element issues.
- Open your Revit project and ensure the parameters you want to read and the target parameter already exist.
- In Revit, select all elements you want to update (for example, all doors or all beams in a view).
- In Assistant, add the Combine Parameters task to your workflow.
- Configure the task:
- In Combine Parts, add each source parameter name and any constant text parts (constant text must be in quotes, for example
" - ").
- In Combine Parameter, enter the name of the parameter that should receive the combined result (for example
Combined Name or Mark).
- In Combine String, set the separator between parts (for example
-, _, , , or leave empty).
- Run the workflow.
- After it finishes, review the result message for any errors, then check a few elements in Revit to confirm the target parameter is updated as expected.
- Causes: No Revit document is open or active when the task runs.
- Solution: Open a Revit model and ensure it is active, then run the task again.
- Causes: Combine Parameter is empty.
- Solution: Edit the task configuration and enter a valid target parameter name exactly as it appears in Revit.
- Causes: Combine Parts is empty or all entries are blank.
- Solution: Add at least one parameter name or constant (in quotes) to Combine Parts.
- Causes: No elements were selected in Revit when the task ran.
- Solution: Select the elements you want to update in Revit and run the workflow again.
- Causes: The specified Combine Parameter does not exist on that element or category.
- Solution: Check that the target parameter exists on those elements and is spelled correctly. Adjust your selection or add the parameter to the required categories.
- Causes: The target parameter is read-only, formula-driven, or not a text field, or the element cannot be edited.
- Solution: Use an editable text parameter as the target. Avoid system or formula parameters.
-
Q: When should I use Combine Parameters?
A: Use it when you need a single text field built from multiple parameter values and/or fixed text, such as combined names, codes, or labels for schedules and tags.
-
Q: How do I add fixed text between parameters?
A: In Combine Parts, add the fixed text in double quotes, for example " - " or "Beam". The quotes are removed automatically, and the content is used as-is.
-
Q: What if a source parameter is missing on some elements?
A: That part is simply skipped for those elements. Other valid parts are still combined.
-
Q: Can I rerun the task after changing parameters?
A: Yes. Running it again overwrites the target parameter with a new combined value based on the current parameter values and configuration.