This extension copies parameter values from one set of Revit elements to another, based on a matching key value.
You choose:
- Which elements to copy values from
- Which elements to copy values to
- Which parameter to use as the matching key (on both sides)
- Which parameters to copy from the source elements to the target elements
The extension then automatically finds pairs of elements where the key values match and copies the specified parameters. This is useful when you need to synchronize parameters between linked models, different categories, or elements that do not have direct Revit relationships.
- What it is: Filters in one or more Revit documents that define the source elements (the ones you copy values from).
- How it behaves: Can include elements from multiple documents, including links.
- Effect: Only elements found by this filter are considered as sources. If this is empty, the extension will fail with “No 'From' collectors specified”.
- What it is: A filter that defines the target elements (the ones you copy values to) in the active document.
- Defaults / special behavior:
- Targets are always selected in the currently active Revit document.
- Targets cannot span multiple documents.
- Effect: Only elements found by this filter are updated. If this is not set, the extension will fail with “No 'To' collector specified”.
- What it is: The name of the parameter on the From elements used as the matching key.
- How to select: Can be chosen from Shared Parameters and Built-In Parameters.
- Expected value: A parameter that uniquely (or at least consistently) identifies corresponding elements between From and To sets, such as a code, room number, mark, or GUID.
- Effect: The extension builds an internal lookup table mapping key values to source elements. If no source elements have a value in this parameter, you’ll get: “No source elements found for the given 'From' key parameter”.
- What it is: The name of the parameter on the To elements used as the matching key.
- How to select: Can be chosen from Shared Parameters, Project Parameters, and Built-In Parameters.
- Expected value: Must contain values that match the From key parameter values (same coding system / IDs).
- Effect: For each target element, the extension reads this parameter and tries to find a source element with the same key. If this field is empty, the extension will fail with “To key parameter is not specified”.
- What it is: A mapping of source parameter → target parameter.
- How to use: Add one row per parameter you want to copy:
- First column: parameter name on the From elements (source).
- Second column: parameter name on the To elements (target).
- How it behaves: For each matched element pair, the extension reads the value from the source parameter and writes it into the target parameter.
- Validation: If this mapping is empty, the extension will fail with “No parameter copies specified”.
Internally, the extension performs the following steps:
- Verifies there is an active Revit document and that all required configuration fields are filled in.
- Builds a lookup from all From elements using the From key parameter (key value → source element). Only the first element per key is kept.
- Starts a single Revit transaction in the active document.
- Loops over all To elements and, for each element:
- Reads the To key parameter.
- Finds a matching source element with the same key.
- For each entry in Parameter copies:
- Reads the value from the source parameter.
- Tries to write it into the target parameter.
- Records success or failure for each parameter and element.
- Commits the transaction and returns a text summary of what happened, including counts by result type and per-element details.
-
Prepare your model(s)
- Ensure that the Revit model(s) contain:
- A parameter that can act as a key on both source and target elements.
- The source parameters with correct values already set.
- The target parameters that you want to fill or update.
- Make sure the active Revit document is the one you want to update.
-
Configure the extension
- From: Set up filters to get the elements to copy from.
- To: Set up filters to get the elements to copy to in the active document.
- From key parameter: Select the parameter on the From elements that contains the value to match on.
- To key parameter: Select the parameter on the To elements that contains the value to match on.
- Parameter copies: Add rows where each maps a source parameter to a target parameter.
-
Run the extension
- Add the extension as a task in an Assistant workflow or run it directly.
- Start the run with the correct Revit model open and active.
-
Verify results
- Review the text output for counts of succeeded and failed updates.
- Spot-check a few target elements in Revit to confirm that parameters have been updated as expected.
- Causes:
- The
From filter does not select any elements.
- The selected elements do not have the From key parameter.
- The From key parameter is empty for all selected elements.
- Solution:
- Verify the
From filter by checking selected elements in Revit.
- Confirm the From key parameter exists and has non-empty values on the expected elements.
- Causes:
- The To key parameter on a target element does not match any source key.
- The target parameter specified in
Parameter copies does not exist on that element.
- The parameter type is not compatible with the value being copied.
- Solution:
- Review the result text for failed entries and note element IDs and messages.
- Ensure keys match between From and To, and that the target parameters are defined on the relevant categories.
- Causes: The From or To filters were left empty or misconfigured.
- Solution: Reopen the configuration and ensure both
From and To filters select at least one element.
- Causes: The transaction failed to commit or the run was cancelled.
- Solution: Keep Revit open and responsive during the run, check for blocking Revit warnings, and try again, possibly with a smaller selection.
-
Q: When should I use this instead of manual copying?
- A: Use it when you need to copy parameter values between many elements that can be matched by a key, especially across documents, categories, or models.
-
Q: Can I copy between different categories or documents?
- A: Yes.
From can include multiple documents; To targets the active document. As long as keys and parameters line up, copying works across categories and models.
-
Q: What if multiple source elements share the same key?
- A: The extension uses the first source element it encounters for that key and ignores later ones.