<aside> <img src="/icons/graduate_orange.svg" alt="/icons/graduate_orange.svg" width="40px" /> Welcome to the Revit Tools documentation for the Superior Electric Revit Toolbox. Use this page to learn about the available tools and how to use them. If you have any questions, please feel free to reach out or leave a comment.

</aside>

Automation

Bulk Exporter

Description

Bulk export multiple files types from Revit. The export settings can be saved to be used at a later time.

How to Use

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/a26c7b79-39bb-40e7-84d4-20ab83de8cdb/export_view32.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/a26c7b79-39bb-40e7-84d4-20ab83de8cdb/export_view32.png" width="40px" /> Select the command Bulk Exporter from the Superior tab under the Automation ribbon panel. When selected, a dialog will open.

</aside>

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/bb9897de-562b-4f96-8324-62afc8214d07/export_view32.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/bb9897de-562b-4f96-8324-62afc8214d07/export_view32.png" width="40px" /> Review the layout of the dialog.

UI Dialog for the Bulk Exporter command.

UI Dialog with Selected File Types

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/57b9089c-616b-434f-b1e0-4bfec0c189c5/settings_load_accent.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/57b9089c-616b-434f-b1e0-4bfec0c189c5/settings_load_accent.png" width="40px" /> Load Settings provides the option to load in previously saved settings.

</aside>

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/a05cf726-05e0-48d0-8344-747b6d24a4dd/view_accent.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/a05cf726-05e0-48d0-8344-747b6d24a4dd/view_accent.png" width="40px" /> Views shows the Revit document’s views. The views can be filtered by view type, searching, or showing on the selected views.

</aside>

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/a8fc559d-c047-4a26-920e-abafb8e4d557/settings_accent.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/a8fc559d-c047-4a26-920e-abafb8e4d557/settings_accent.png" width="40px" /> Options provides the selection for different export options based on the file type that is selected.

</aside>

Save To selects the folder location where to save the exported files. Select on either the text or the three dots to open a folder selection dialog.

</aside>

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/7c9ad9ef-595f-410b-9bdb-d36349de539b/file_accent.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/7c9ad9ef-595f-410b-9bdb-d36349de539b/file_accent.png" width="40px" /> Name provides a text box to enter a naming template to apply to the views being exported.

</aside>

<aside> <img src="/icons/report_lightgray.svg" alt="/icons/report_lightgray.svg" width="40px" /> Please note: PDF exporting is not available for Revit 2021. Revit 2021 does not provide this functionality, though a workaround is in development.

</aside>

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/f9338017-33ec-4859-b482-f872c95a3c4c/export_view32.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/f9338017-33ec-4859-b482-f872c95a3c4c/export_view32.png" width="40px" /> When creating a naming template, there are some wildcards that can be used. The wildcard tags are replaced with their corresponding values when creating the file.

Date provides the current date in the format YYYY-MMDD.

View Name provides the name of the view. If it is a sheet, the sheet name will be used.

Sheet No. provides the sheet number. This only applies to views that are sheets. If multiple files types are being exported, the Sheet No. wildcard will be skipped for views that are not sheets.

Title provides the document’s title (Revit file name).

Additional text can be added to the name, such as a prefix, suffix, or any separators between each wildcard tag.

<aside> <img src="/icons/report_lightgray.svg" alt="/icons/report_lightgray.svg" width="40px" /> Please note: PDF files with the same name will be overwritten. For example, if only View Name is specified and two views have the same name, the file will be overwritten. All other file types will add a number to the file name such as view name (2).dwg.

</aside>

Documentation

Sheet Index Dots

Description

Create Project Parameters for each Revision in a Revit Document to be applied to the Sheet Index. Each sheet will be updated to show a dot on the corresponding Revision in the Sheet Index schedule.

How to Use

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/2b91d168-de76-44d9-8cb7-e245d3d9ff94/sheet-index-dots32.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/2b91d168-de76-44d9-8cb7-e245d3d9ff94/sheet-index-dots32.png" width="40px" /> Select the command Sheet Index Dots from the Superior tab under the Documentation ribbon panel. When selected, a dialog will open.

</aside>

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/2b91d168-de76-44d9-8cb7-e245d3d9ff94/sheet-index-dots32.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/2b91d168-de76-44d9-8cb7-e245d3d9ff94/sheet-index-dots32.png" width="40px" /> Review the layout of the dialog. The Revision section provides a view of the Revisions available in the Revit document. The buttons on the side are activated based on the status of the Revision.

UI Dialog for the Sheet Index Dots command.

<aside> <img src="/icons/report_lightgray.svg" alt="/icons/report_lightgray.svg" width="40px" /> A halftoned Revision asserts that the Revision is already a Project Parameter and allocated in the Sheet Index schedule. A full-toned Revision asserts that the Revision is NOT allocated in the Sheet Index schedule.

</aside>

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/2b91d168-de76-44d9-8cb7-e245d3d9ff94/sheet-index-dots32.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/2b91d168-de76-44d9-8cb7-e245d3d9ff94/sheet-index-dots32.png" width="40px" /> Select the Revisions to add into the Sheet Index schedule. Each button will do the following:

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/e41b949e-ddd2-48c4-beb2-6c0c62699caa/sheet_accent.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/e41b949e-ddd2-48c4-beb2-6c0c62699caa/sheet_accent.png" width="40px" /> Adds/Removes a ‘■’ to the Project Parameter value of each corresponding Revision within the Sheet Index. The value will be added if the sheet has a Revision Cloud or tagged as part of the respective Revision. Note: this button can be clicked at any time and does not need to have a Revision selected.

</aside>

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/7bf26b76-8dbe-43f6-a3f4-f055a93869c1/checkmark_accent.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/7bf26b76-8dbe-43f6-a3f4-f055a93869c1/checkmark_accent.png" width="40px" /> Adds the selected Revision as a Project Parameter and allocates it into the Sheet Index. Note: this button will also update the sheets’ Project Parameter values as described above.

</aside>

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/c23662a6-7298-4acf-8036-1da954d431ee/remove_accent.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/c23662a6-7298-4acf-8036-1da954d431ee/remove_accent.png" width="40px" /> Removes the selected Revision from the Sheet Index, but keeps the Project Parameter. Note: the Project Parameter can be added back into the Sheet Index at a future time.

</aside>

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/942cad2c-d7e0-45b1-92b7-19e332fb56c1/trash_accent.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/942cad2c-d7e0-45b1-92b7-19e332fb56c1/trash_accent.png" width="40px" /> Deletes the selected Project Parameter corresponding to the Revision from the Revit document.

</aside>

Remarks

<aside> ❗ The Sheet Index schedule must have the name ‘Sheet Index’. The command will not run if there is no schedule named ‘Sheet Index’.

</aside>

Manage

Shared Parameters

Description

Modify and import Shared Parameters from Superior Electric’s globally shared Shared Parameter file.

How to Use

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/d80c4bc5-c1cc-4a04-aac5-db0b815a9644/add_parameters16.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/d80c4bc5-c1cc-4a04-aac5-db0b815a9644/add_parameters16.png" width="40px" /> Select the command Shared Parameters from the Superior tab under the Manage ribbon panel. When selected, a dialog will open.

</aside>

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/a03a93c3-9b50-4b50-8c37-2dd96cc78966/add_parameters16.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/a03a93c3-9b50-4b50-8c37-2dd96cc78966/add_parameters16.png" width="40px" /> Review the layout of the dialog.

When opening, you will see a Connecting… loading screen. The tool is connecting to the database which hosts the shared parameters.
Once loaded, you will be presented with a window dialog that has similar functionalities as Revit’s native shared parameter modification window.
The Parameter Group drop down allows you to select the parameter group in which parameters are associated with (similar to Revit’s functionality).
When a Parameter Group is selected, the parameters associated with the group will be populated under the Parameters panel.

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/f5d92c43-bea2-4362-9bb7-791a522e9edc/search_accent.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/f5d92c43-bea2-4362-9bb7-791a522e9edc/search_accent.png" width="40px" /> Note: Use the search bar to search for a parameter using its name.

</aside>

UI Dialog for the Shared Parameters command.

After selecting a parameter, the Parameter Properties will be populated with the selected parameter’s properties. You may select more than one at a time, though only one selection can be made to view the parameter’s properties.
From here, you may modify parameters by adding, editing, or deleting. You may also import it into the current Revit document.

UI Dialog for the Shared Parameters command after selections are made.

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/80f29bbb-bf16-4c62-8813-390ad688a4d5/add_parameters16.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/80f29bbb-bf16-4c62-8813-390ad688a4d5/add_parameters16.png" width="40px" /> Under the Parameter Groups section, each button will do the following:

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/aa69c30d-1ccb-4f08-84cb-e2eba9b50d4e/add_accent.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/aa69c30d-1ccb-4f08-84cb-e2eba9b50d4e/add_accent.png" width="40px" /> Opens a dialog to create a new Parameter Group.

</aside>

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/560ee551-31f4-4bc2-a40e-c26da32fac11/edit_accent.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/560ee551-31f4-4bc2-a40e-c26da32fac11/edit_accent.png" width="40px" /> Opens a dialog to edit the selected Parameter Group.

</aside>

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/d1e004e9-b445-459f-8391-16fcb501a116/trash_accent.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/d1e004e9-b445-459f-8391-16fcb501a116/trash_accent.png" width="40px" /> Opens a dialog to delete the selected Parameter Group. A Parameter Group cannot be deleted if it contains parameters.

</aside>

Under the Parameters section, each button will do the following:

</aside>

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/560ee551-31f4-4bc2-a40e-c26da32fac11/edit_accent.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/560ee551-31f4-4bc2-a40e-c26da32fac11/edit_accent.png" width="40px" /> Makes the Parameter Properties panel editable for properties that can be edited, such as Name and Description.

</aside>

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/e6fae73f-d2c0-4d09-86e8-4ef74be6b47b/cloud_sync_accent.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/e6fae73f-d2c0-4d09-86e8-4ef74be6b47b/cloud_sync_accent.png" width="40px" /> Updates the current parameter to the latest version. This button will only show if the parameter can be updated.

</aside>

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/2f4964a0-aa2c-4ff2-9b1c-786e2e4b87de/import_accent.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/2f4964a0-aa2c-4ff2-9b1c-786e2e4b87de/import_accent.png" width="40px" /> Opens a dialog to import the selected parameters into the current Revit document. This button will only show if the parameter is not already in the document.

</aside>

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/8668bd8c-deb6-4f17-be5a-058c8ab90493/cloud_upload_accent.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/8668bd8c-deb6-4f17-be5a-058c8ab90493/cloud_upload_accent.png" width="40px" /> Opens a dialog to upload existing shared parameters from a text file.

</aside>

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/85792ca7-88cd-4c2d-9690-80bec13a38a4/import_accent.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/85792ca7-88cd-4c2d-9690-80bec13a38a4/import_accent.png" width="40px" /> Review the layout of the Import Parameters dialog.

The Selected Parameters panel shows the parameters that were selected to import into the Revit document from the main dialog. The parameters are not selectable as a default.
The Group Under drop down assigns the grouping for the parameter within the Revit document.
The Instance Parameter checkbox selects whether the parameter is an Instance parameter. If not checked, the parameter will be a Type parameter.
The Apply to All Parameters checkbox selects whether all the properties should be assigned to all the selected parameters. If this is unchecked, the parameters will become selectable and each one can be assigned individually.
The Categories panel shows the Revit categories to assign the parameters.

<aside> <img src="/icons/report_lightgray.svg" alt="/icons/report_lightgray.svg" width="40px" /> The Categories panel will not show up if the current Revit document is a Family document.

</aside>

UI Dialog for Import Parameters, shown after selecting Import on the main dialog.

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/7ff392f8-3f37-45b8-9615-a9ed6e1587cb/import_accent.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/7ff392f8-3f37-45b8-9615-a9ed6e1587cb/import_accent.png" width="40px" /> Each button will do the following:

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/3e4587ee-0a9c-492b-b8eb-232d9b4324d0/checkmark_accent.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/3e4587ee-0a9c-492b-b8eb-232d9b4324d0/checkmark_accent.png" width="40px" /> Imports the parameters with the provided options.

</aside>

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/1cd413d0-e363-4703-8778-a56c64c67fe7/close_accent.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/47d85232-54a5-4fd7-b34b-0ca2bcb099bc/1cd413d0-e363-4703-8778-a56c64c67fe7/close_accent.png" width="40px" /> Cancels the import and closes the dialog.

</aside>

Remarks

<aside> ❗ Family type parameters are not available to add to your Family with this tool. These parameters will not show up on the list to add.

</aside>

Configuration

Preferences

Description

Modify your plugin preferences.

How to Use

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/d7a7cf97-7b15-462a-8725-9d06b369d81a/preferences32.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/d7a7cf97-7b15-462a-8725-9d06b369d81a/preferences32.png" width="40px" /> Select the command Preferences from the Superior tab under the Configuration ribbon panel. When selected, a dialog will open.

</aside>

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/c3ecd4b9-3b75-40c4-ab58-cd7efafa15a5/preferences32.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/c3ecd4b9-3b75-40c4-ab58-cd7efafa15a5/preferences32.png" width="40px" /> Review the layout of the dialog.

The UI Theme allows you to switch between a light and dark mode for any plugin tool UI.
The Release Status allows you to choose which release you would like to be on for the plugin.

UI Dialog for the Preferences command.

</aside>

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/8eeba913-e633-4e6f-94e1-a8bf9b841f61/preferences32.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/8eeba913-e633-4e6f-94e1-a8bf9b841f61/preferences32.png" width="40px" /> Each action will do the following:

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/e3a539ec-b7ad-476f-ac92-265c2664df0f/sun_accent.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/e3a539ec-b7ad-476f-ac92-265c2664df0f/sun_accent.png" width="40px" /> Toggles between Light and Dark mode for any plugin tool UI. See the differences as you toggle between them.

</aside>

<aside> <img src="/icons/branch-create_orange.svg" alt="/icons/branch-create_orange.svg" width="40px" /> Chooses the release status of the plugin. Alpha allows you to test new features and modifications, though they may not work as expected. Beta allows you to test new features while existing features are unmodified and working as expected. Release will only have functional features available, though some bugs may exist.

</aside>