Skip to content

Selection Toolbar#

The selection toolbar is designed to navigate and quickly manage selections. By design the selection toolbar is intended to look and feel like the navigation toolbar found in popular file/web browsers. Mastering navigation is very simple and it's one of the keys to work faster in Clarisse.

Selection Toolbar

Clarisse selection toolbar

The selection toolbar is divided in two parts. On the left you'll find navigation buttons and on the right the selection field displaying the build path to the current selection.

Selection Field#

If we look at the previous screenshot, image, displayed in orange in the selection field, is selected. In this example, the full path of the selection is build://project/scene/image where image is an object and project and scene are contexts. However, the project path of the selected item is project://scene/image.


For more information on item paths in Clarisse please refer to Understanding the Workflow/Items path

The application selection field always display the current application context. In this example, the current context of the application is build://project/scene.


New items created using the main application menu bar are always created in the current context of the application.

In the same way, you would click on a folder button in a file browser to dive into a folder, clicking on a context button selects the context. It's very quick and intuitive to browse to the context you are looking for.

Clicking on the drop down arrow pops up a menu displaying all sub-contexts. If you select one of the sub-contexts, the selection field path gets automatically updated.


Using the selection field, you can directly select objects. To select objects, click on the text field and directly type the path to your object. Notice while typing a selection list with an auto-complete feature pops up. Use the mouse or the Up and Down arrow key to scroll through the project items.

Selection field with auto-complete

Selection field with autocomplete


When a selection is composed of multiple items, the selection field displays the name of the last selected item followed by the number of selected items between square brackets [].

For example, let's say we have a multiselection containing two items image and box, the selection field then displays box[2].

While in multiselection, there is also a drop down arrow displayed after the square brackets []. If you click on the drop down arrow located after the square brackets [], a menu displaying the content of your selection pops up.

Selection History#

Each time the selection is modified, the previous selection is stored in the selection history. You can limit the size of the selection history using the Preferences Panel by going to Edit > Preferences... or using Ctrl+K.

To display the current selection history, click on the drop down arrow located on the left of Next Selection button.

The selection history menu lets you browse the history menu and the content of selection sets. Using this menu, you can change the current selection to a former one or you can explicitly change the selection to an individual member of a previous selection set.

Selection sets are displayed using the square brackets [] formalism described in the Multiselection section. However, you can browse the set content by hovering the mouse over a selection set that has multiple items within it.

To clear the selection history, pop up the selection history and choose Clear Selection History.

The selection toolbar also offers quick access to the selection history and more. Most of these actions can be found in the Edit menu of the application main menu bar.

Icon Shortcut Name Function
Left Backspace Previous Selection Set current selection to the previous one found in the selection history.
Right Shift+Backspace Next Selection Set current selection to the next one found in the the selection history.
History None Selection History Display the content of selection history.
Input Alt+Page Up Select Input Select items that are connected to the item(s) of the selection.
Output Alt+Page Down Select Output Select items that the selection is connected to.
Source Ctrl+Page Up Select Source(s) Select current selection sources. This is only available when the selection has instances.
Instance Ctrl+Page Down Select Instance(s) Select current selection direct instances. This is only available by the selection has sources.

Local Selection and Selection Slots#

Clarisse offers a very complete system for the selection going beyond the global application selection. Indeed, selections can be local to a widget or can be shared across multiple ones via a system of slots.

For more information regarding the widget selection and slot system please refer to Managing Widgets Selection.

Promoting Custom Global Variables#

The main application selection toolbar lets you add shortcuts to useful custom global variables to drive items. For example, you may use a global variable that sets the Sampling Quality for all your render layers or may use a variable to switch the current shot number when doing sequence lighting or simply switch asset version.

!!! Note New to Clarisse? The main selection toolbar is located under the main application menu bar. For more information about the Selection toolbar please refer to Selection.

Selection toolbar Variables


To add a new global variable to the selection toolbar, click on the 3 dots icon next to Vars and choose the variable you wish to promote. The selection toolbar will then display your variable.


Using the same menu it is also possible to demote promoted variables.

Setting Application Vizroot#

The current vizroot of the application is displayed completely to the right of the selection toolbar. Using the button, it is possible to browse and set the current vizroot. click on the button and choose Choose Vizroot > Browse... to set the current vizroot, Choose Vizroot > From Selection to set the vizroot from the current selection, or Choose Vizroot > From Selection Origin to set the vizroot from the source of the currently selected item. The source of the currently select item is the top most context the item has been originally created.


This feature is only available in Clarisse BUiLDER.