Toolbar Menu



Worksession >


The Worksession command manages a list of models that are being used as reference geometry.


For a description of the process Rhino 5.0 uses to locate files used by worksessions and linked instance definitions, see Rhino Wiki: File finding.

Layer settings

The attached file geometry appears on a unique set of layers under a parent layer with the name of the attached file, and the attached file layers as sub-layers of the parent.

You can change the layer state of reference layers (Color, On/Off, and Locked/Unlocked), but you cannot add new layers to or delete layers from the attached file. The list of attached files are not saved in the current model file, but are saved in the worksession file (.rws).


  1. In the Worksession Manager dialog box, click Attach.
    Drag any supported geometry file format from Windows Explorer, and in the dialog box, click Attach file.
  2. Select files to attach.
  3. To save the worksession for future use, click Save or Save As.
    The current worksession name appears in the dialog box title.

When you open a worksession file:

Worksession Manager


Marks the file that is currently open for editing.


Displays the locked/unlocked status of the attached files. A tooltip on the lock icon shows information about who has the file open.


The attached model name.


The path to the attached file.



Attaches an external file to the worksession list.


Removes the external file from the worksession list.


The selected model is open for editing.

Note: Only .3dm files can be made active. Other file formats may be attached, but cannot be the active file.

The current model closes and becomes an attached model. You are prompted to save changes in the currently active model.


Refreshes the selected attached files.

Lock Info

Displays the locked/unlocked status of the attached files and information about who has the file open.



Opens a worksession file.


Saves a worksession file.

Save As

Saves a worksession file as another name.


Closes the Worksession Manager.

Resolving render content conflicts

Rhino detects material, environment and texture name conflicts in the following file operations:

When a render content item name already exists in the current model, but the content settings are different, the conflicted items will be resolved based on the related advanced settings.

Search for PasteConflictOption (for paste) and ImportRenameConflictingEx (for import and insert) in Advanced settings and change the value as described below.

0 = Do not import incoming conflicted render contents.

1 = Import and rename incoming conflicted render contents with [imported] post-fix.

2 = Import incoming conflicted render contents and overwrite existing ones.

3 = Pop up the Render Content Name Conflict dialog and let you decide how to resolve the conflicts.

Related commands


Toolbar Menu



Worksession > Limit

The LimitReferenceModel command limits the amount of reference geometry that is available to work on by purging the reference geometry that is not needed in the area of interest.

This can make Rhino's display more responsive or simply cull unwanted visual clutter.


Command-line options


Sets the limits of the model.


For models with previously applied limits, reloads the current worksession file, restoring the purged objects.


Toolbar Menu

Not on toolbars.

Not on menus.

The PurgeRefObjects command deletes selected worksession reference objects from Rhino.

This command is useful for hiding unwanted worksession geometry during the work session.



The Undo command does not work for the PurgeRefObjects> command. To recover the purged objects, activate another attached file or click the Refresh All button in the Worksession Manager dialog to reload the worksession model.

See also

Work with files

Manage views

Rhino Wiki: File finding




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