092 Copy Plan Region By Parameter

Overview

Copy Plan Region By Parameter propagates plan region layouts from a single template view to any number of target floor plan views. Instead of recreating plan regions manually on each view, you add a text parameter to your views, set it to reference the template view, and run the tool — which copies the plan region geometry and (optionally) the base view range to every matching view simultaneously. A task that would take days on a large project runs in seconds.

Table of Contents

• Key Features
• Requirements
• Running the Tool
• Tips and Best Practices
• Common Use Cases
• Troubleshooting

Key Features

• Works with floor plan views only — view type is filtered to floor plans
• Two parameter dropdowns: one for filtering/searching target views, one for reading the source view reference
• Source view reference format: ViewType: ViewName (e.g. Floor Plan: Level 1)
• Match Base View Range checkbox — optionally copies the View Range settings from the template view
• Select Selected / Select All / Select None buttons for the target view list
• Progress bar with Cancel button
• Completion message: "X views updated. Y views failed."
• Transaction: "Update View Regions"

Requirements

• Must be run in a project document (not a Family document)
• A text parameter (project or shared) must be added to Views before running
• That parameter must contain a value in the format ViewType: ViewName pointing to the source template view
• The source view referenced by the parameter must exist in the project
• A valid Kiwi Codes Bonus Tools licence must be active

Running the Tool

Setup — Add a parameter to views

Before using this tool, a text parameter must be added to Views and populated with the source view reference.

1. Create a Project Parameter (or Shared Parameter) of type Text, bound to the Views category.

2. Create or designate one floor plan view as the plan region template — set up all plan regions on this view exactly as required.

3. On each target view (the views you want to update), open its properties and set the new parameter to the source view in ViewType: ViewName format:

   Floor Plan: Level 1
   

   Where:

   • Floor Plan — the exact View Type name
   • : — separator (colon + space)
   • Level 1 — the exact name of the template view

Launch

Find Copy Plan Region By Parameter on the Bonus Tools Ribbon or use 115 Search Tools.

Step 1 — Configure the search

Select the View Type from the dropdown to filter the view list to floor plan views. Select a search by Parameter (the first parameter dropdown) to define which parameter to search on, and enter a keyword to narrow the results if needed.

Step 2 — Select target views

The view list populates with matching views. Select the views you want to update.

Step 3 — Select the source-reference parameter

In the second parameter dropdown, select the parameter that contains the ViewType: ViewName source reference (the parameter you set up in the setup step above).

Optionally enable Match Base View Range to also copy the View Range (Top, Cut Plane, Bottom offsets) from the template view to each target view.

Step 4 — Execute

Click OK. For each selected target view, the tool:

1. Reads the source-reference parameter value
2. Parses ViewType: ViewName to locate the template view
3. Copies all plan regions from the template view to the target view
4. Optionally copies the View Range settings

When complete: "X views updated. Y views failed."

Tips and Best Practices

• Use a dedicated parameter name that is easy to find. A name like "Plan Region Template" or "View Template Source" makes it clear what the parameter is for in the Properties panel.
• One template view can drive hundreds of target views. All views that share the same parameter value will be updated to match the same template.
• Update the template view first, then re-run. Whenever plan regions on the template change, re-run Copy Plan Region By Parameter to propagate the changes to all target views.
• Enable Match Base View Range for views that should have identical visibility depth. This ensures the cut plane and view range are consistent across all updated views.
• Leave the parameter blank on views that should not be updated. Only views with a non-empty parameter value pointing to a valid source view are processed.

Common Use Cases

Propagating plan regions to all floors of a multi-storey building — Set up plan regions on the Level 1 floor plan. Add the parameter to every other level's floor plan referencing Floor Plan: Level 1. Run the tool to push the same layout to all floors in seconds.

Applying coordination plan regions project-wide — A coordination floor plan has specific plan regions marking structural zones. Propagate those regions to all discipline floor plans that need to match.

Maintaining plan region consistency during design changes — When plan regions change (e.g., a new mezzanine), update the template view and re-run to keep all target views in sync automatically.

Setting up view range consistency — Enable Match Base View Range alongside plan region copying to ensure all target views have the same cut plane and view range as the template.

Troubleshooting

"X views updated. Y views failed." with failures Check that the parameter value is correctly formatted as ViewType: ViewName on the failed views. The ViewType must match exactly (e.g. Floor Plan not Floorplan). The template view name must also match exactly.

"Plan Region failed. Gain ownership of elements and try again." The overall transaction failed due to a worksharing conflict. Gain element ownership via SWC tools in Revit and re-run.

No views appear in the list Verify the selected View Type matches the views in the project, and check that the search parameter is set correctly. Ensure the project contains floor plan views with the search parameter attached.

Plan regions are copied but the result looks different from the template Plan regions are copied by geometry, not by linked association. If the template view uses crop region offsets or levels that differ from the target view, the regions may appear in unexpected positions. Verify that the target view covers the same area as the template.

View Range was not copied even with Match Base View Range enabled The target view may be on a different level than the template, causing the View Range copy to fail silently. Check that the target view's associated level is appropriate for the copied View Range values.