Toolbar Menu





The Grasshopper command opens the Grasshopper® plug-in window. Grasshopper is a graphical algorithm editor tightly integrated with Rhino's 3-D modeling tools.

To access command-line options

Command-line options


Loads the Grasshopper plug-in and controls the visibility of the Grasshopper window.


Loads the Grasshopper plug-in, but does not open the Grasshopper window.


Opens the Grasshopper window. The Grasshopper plug-in will be loaded if it is not.


Hides the Grasshopper window when it is open.


Changes visibility of the Grasshopper window.


Browses, or enters a path to open a Grasshopper file (*.gh, *.ghx).


Saves the current Grasshopper file.


Saves the current Grasshopper file with a different name.


Closes the current Grasshopper file. Unsaved data will be lost.


Closes all the opened Grasshopper files. Unsaved data will be lost.


Unlocks the Grasshopper solver. Grasshopper resumes computing interactive data.


Locks the Grasshopper solver. Grasshopper stops computing interactive data.


Changes the locking status of the Grasshopper solver.


Changes visibility of the Grasshopper banner when the scriptable version command, -Grasshopper, is loading the Grasshopper plug-in.


Shows the Grasshopper banner.


Hides the Grasshopper banner.

Separate V5 and V6 components

There are two different ways to hide plug-ins from Grasshopper for Rhino 5 and Rhino 6 respectively.

To hide a plug-in from Grasshopper in V5

To hide a plug-in from Grasshopper in V6

Reset Grasshopper settings back to default

You may need to erase all custom settings or disable plug-ins in Grasshopper to have a fresh start in some situations.

To erase all custom settings

  1. In Grasshopper, select File > Special Folders > Settings Folder to open the folder containing the setting files.

  2. Close all Rhino windows.

  3. Delete the .xml files in the folder, or move them elsewhere if you need to put the settings back later.

To disable plug-ins

Grasshopper plug-ins can be disabled in different ways.

See Also


Assists in the discovery, installation, and management of Rhino and Grasshopper plug-ins.

Find more plug-ins on food4Rhino.



Toolbar Menu

Not on toolbars.

Not on menus.

The GrasshopperDeveloperSettings command manages Grasshopper plug-in (*.gha) loading behavior and locations. There are better functionalities in the current Grasshopper that can entirely replace this command.

Memory load *.GHA assemblies using COFF byte arrays

Windows systems do not allow loading DLL files from "unsafe" locations such as network drives. When checked, plugin files are first read from the disk into memory, and then loaded from memory into the application. This option makes it possible to load a plug-in stored on a server. It is not recommended to change this option. There are now better ways to set per plug-in loading behavior in Grasshopper (File > Preferences > Solver > Plug-in loading).

Library folders
Add Folder

Click to add an extra folder from where *.gha files will be loaded in addition to the default locations. Plug-in developers can add the Visual Studio build folder and load *.gha files from there.

Valid Folders

Click to show the folders from where Grasshopper attempts to load plug-ins. You cannot edit the list, but the list can help to find the location of specific plug-ins.

See also

Make Grasshopper ignore a plug-in



Toolbar Menu

Not on toolbars.

Not on menus.

The GrasshopperFolders command opens the folders where Grasshopper stores files of settings, user objects, clusters or components.

Open one of the folders

  1. Run the command.
  2. Select one of the options.



Toolbar Menu

Not on toolbars.

Not on menus.

The GrasshopperGetSDKDocumentation command downloads the Grasshopper SDK help document (.CHM) from the Internet.



Toolbar Menu

Not on toolbars.

Not on menus.

The GrasshopperIgnorePlugin command allows selecting a .gha file that will be ignored by Grasshopper. A *.no6 file is created beside the .gha file that tells Grasshopper not to load it.

Make Grasshopper ignore a plug-in

  1. Run the command.

  2. Select a .gha file.

    If the .gha file is in a folder that you do not have full control, you will have to run Rhino by right-clicking on the Rhino desktop icon and select "Run as administrator," otherwise the *.no6 file cannot be created.

Make Grasshopper load an ignored plug-in



Toolbar Menu

Not on toolbars.

Not on menus.

The GrasshopperLoadOneByOne command prompts before loading every plug-in. Use this command to find out the plug-in that crashes Grasshopper on startup.


  1. Run the command when Grasshopper is not loaded.
  2. Click Yes to load a plug-in. The path of the *.gha file is copied to Windows clipboard.
  3. Click No to disable a plug-in in this Rhino session.






Grasshopper Player

The GrasshopperPlayer command allows to load and execute a grasshopper definition (*.gh, *.ghx) without showing the Grasshopper window.


  1. Start the command.

  2. Select a *.gh or *.ghx file to open.

To script the command

Type a hyphen in front of the command name: -GrasshopperPlayer

The scriptable command supports system environment variables for file paths.

For example:

-_GrasshopperPlayer %USERPROFILE%\

opens C:\Users\{Username}\


  • Enclose the file path in double-quotes if it contains any spaces like:

    "%USERPROFILE%\my gh"

If the grasshopper definition file is missing, Rhino would look for the file in these locations:

If the grasshopper definition file is stored in one of the locations, you can enter the file name without the full path like:



Toolbar Menu



Grasshopper Plug‑in List

The GrasshopperPluginList command shows the plug-ins used in the currently loaded Grasshopper file.





Rhinoceros 8 © 2010-2024 Robert McNeel & Associates. 07-Jun-2024