top of page

Revit Plugin : Custom Toolbar

Using PyRevit to Create a Revit Plugin

We'll go through how to use PyRevit to build a custom tool for Autodesk Revit in this blog article. With the help of the potent Python library PyRevit, programmers may build unique Revit plugins that improve the software's capabilities.

Getting Started with PyRevit

Python is an open-source extension that may be used to create Revit plugins. It offers a straightforward and simple interface for interacting with the Revit API, making it simple to develop customized tools, automate tedious activities, and increase the capabilities of Revit.

Introduction to PyRevit

1. Install Python first. Ensure that Python is set up on your PC. Python 3.7 or later is necessary for PyRevit.

2. Install PyRevit: The PyRevit extension has to be installed next. Visit the PyRevit website ( and adhere to your operating system's installation guidelines

3. Create a New Plugin: Open Autodesk Revit and select the "Add-Ins" tab after PyRevit has been installed. To make a new PyRevit plugin, click the "Create New" button.

4. Write Your Code: At this point, you may begin creating the code for your unique utility. You can utilize the pre-built templates provided by PyRevit as a starting point. Examples for designing unique ribbon panels, commands, and other elements are provided in these templates.

5. Testing and Debugging: Using PyRevit's built-in tools, you may test and debug your plugin after writing the code. PyRevit offers a debug window and a command-line interface to assist you in testing and troubleshooting your code.

6. Distributing Your Plugin: After it is finished, you may make it available to other people. With the help of PyRevit's packaging tool, you can make your plugin easy for others to install and use by packaging it as a typical Revit add-in.

Setting up a Revit Tab

Each extension is a group of tools, organized in bundles to be easily accessible through the user interface.

Create a folder with a your extension name. For example 'Toolbar'

Create a folder and name your extension. In my case it is BimApi. Also add '.extension' to the name. This title is not displaying anywhere.

Create a folder, and it is gonna to be your Tab. This name will appear on the Revit tabs. Example: "" . Also This folder name is the name of the toolbar loaded in the toolbar inside Revit.

Inside the tab folder, create a folder named ".panel". This will be your scripts panel :

These are the folders containing the script and theirs names will be the name of the buttons shown in the bar.

• icon.png : the image of the button in the toolbar, must be in png and a size of 32 x 32 pixels is the optimal resolution. – the script that will be run when the button is pressed. The name can be prefixed with other words to differentiate between scripts

For this script, we are going to save the auto dimension grids script as Dimension inside the Dimension Grids.pushbutton. This is the name that will show inside Revit if we don’t change it inside the script.

Click Save Setting and Reload and you will have your first customized Revit tab with Python scripts!


A fantastic method to improve your Revit workflow and automate tedious processes is by using PyRevit to create a plugin for the software. You may create unique tools that enhance your productivity in Autodesk Revit using the easy-to-use interface and robust capabilities of PyRevit. Why then wait? Start using PyRevit right away to unleash Revit's full potential!

bottom of page