PromptTool – Documentation

PromptTool Command List

The following is a list of commands which can be entered into the PromptTool Input field. The command is executed by clicking “Enter” or pressing the Return key. Commands in this list are presented in the following style:

command items  example command
Description of command

id  id
Returns the Revit ID of the current selection.


select id “Element Id”  select id “12345”
Selects the element with matching Revit Id

select category  select walls
Selects all elements of category

select category “property=value”  select walls “Comments=replace”
Selects all elements of category, where the specified parameter has a certain value. Note: as elsewhere in Revit, parameters are case-sensitive.

select “property=value”  select “Comments=replace”
Selects all elements where the specified parameter has a certain value. Note: as elsewhere in Revit, parameters are case-sensitive.


filter category  filter walls
Modifies the current selection – unselects all elements that aren’t of the specified category

filter category “property=value”  filter walls “Comments=replace”
Modifies the current selection – unselects all elements that aren’t of the specified category or where the specified parameter does not have a certain value. Note: as elsewhere in Revit, parameters are case-sensitive.

filter “property=value”  filter “Comments=replace”
Modifies the current selection – unselects all elements where the specified parameter does not have a certain value. Note: as elsewhere in Revit, parameters are case-sensitive.


get “parameter”  get “Comments”
Returns the value of the specified parameter. Note: as elsewhere in Revit, parameters are case-sensitive.


set “parameter=value”  set “Comments=replace”
Sets the value of a parameter. Note: as elsewhere in Revit, parameters are case-sensitive. Lengths do not require units and should be input as per the Project Units. For example > set “Length=3000” Note also in these cases the command may modify the model including changing Type Properties


vg “off/on”  vg “off”
Hides the selected element(s) by overriding its graphics in the current view

vg “c=red,green,blue,lineweight”  vg “c=255,0,0,2”
Overrides the Cut Line and Cut Pattern colour and lineweight of the selected element(s) in the current view. Lineweight is optional – the command will work without it: vg “c=255,0,0”

vg “p=red,green,blue,lineweight”  vg “p=255,0,0,2”
Overrides the Projection Line and Surface Pattern colour and lineweight of the selected element(s) in the current view. Lineweight is optional – the command will work without it: vg “p=255,0,0”

vg “halftone=on/off”  vg “halftone=on”
Overrides the graphics of the selected element(s) in the current view to either turn halftone on or off

vg category “off/on”  vg walls “off”
Turns off or on the specified categories in the view’s Visibility/Graphics settings

vg category “c=red,green,blue,lineweight”  vg walls “c=255,0,0,2”
Overrides the Cut Line and Cut Pattern colour and lineweight of the specified category in the view’s Visibility/Graphics settings. Lineweight is optional – the command will work without it: vg walls “c=255,0,0”

vg category “p=red,green,blue,lineweight”  vg walls “p=255,0,0,2”
Overrides the Projection Line and Surface Pattern colour and lineweight of the specified category in the view’s Visibility/Graphics settings. Lineweight is optional – the command will work without it: vg walls “p=255,0,0”

vg category “halftone=on/off”  vg walls “halftone=on”
Overrides the graphics of the specified category in the current view to either turn halftone on or off


info  info
Displays information on the current selected element


sheet “sheet name” sheet number  sheet “GROUND FLOOR PLAN” A100
Creates a new Sheet with the specified Sheet Name and Sheet Number. The default Titleblock family is used.


plan “associated level” view name  plan “Ground Floor” Ground Floor GA
Creates a new Floor Plan using the specified associated Level and naming it as per the input View Name


moveto  moveto
Select two elements. The first element will be moved to the location of the second

moveto “offset”  moveto “-600”
Select two elements. The first element will be moved to the location of the second with an offset in the direction the element has moved. A position offset will move it past the target, a negative offset will move it before the target. Do not specify units – Project Units will be used


move x/y/z “distance”  move x “3000”
Moves the selected element the specified distance in an X (East/West), Y (North/South) or Z (Elevation) direction. Do not specify units – Project Units will be used


spin “angle”  spin “45”
Rotates the selected elements around their respective axis.


vos x,y “sheet number”  vos 100,100 “A100”
Moves the selected element the specified distance in an X (East/West), Y (North/South) or Z (Elevation) direction. Do not specify units – Project Units will be used. Use with viewloc command to determine X,Y location of a Viewport on a Sheet.


viewloc  viewloc
Reports the X, Y location of a Viewport on a Sheet


pdf “print set name” pdf “Set 1”
Exports individual PDFs of every item in the Print Set. Sheet Size comes from Sheet and is printed at 100%

pdf “print set name” revision pdf “Set 1” revision
Exports individual PDFs of every item in the Print Set. Sheet Size comes from Sheet and is printed at 100%. Will append Current Revision to filename

pdf combined “print set name” pdf combined “Set 1”
Exports combined PDF of every item in the Print Set. Sheet Size comes from Sheet and is printed at 100%


dwg “print set name” dwg “Set 1”
Exports a DWG of every item in the Print Set using default settings

dwg “print set name” export settings name dwg “Set 1” Settings1
Exports a DWG of every item in the Print Set using specified export settings

runscript runscript
Prompts to load a .txt file which contains a list of all these commands to run in batch

privacy privacy
Shows the privacy statement

How RevitPrompt Works

Discover the step-by-step guide to integrating RevitPrompt with your Revit workflow for maximum efficiency.

Step One: Installation

Begin by installing the RevitPrompt plug-in, setting the stage for a streamlined command-line interface in Revit.

Step Two: Using Commands

Learn how to input commands in RevitPrompt to accelerate tasks and optimize your design process.

Step Three: Enhancing Workflow

Finalize by customizing commands and integrating RevitPrompt fully to boost your project productivity.