# Locating the action

## Target configuration

Shows the three fields which let you configure the target of your action.

Target configuration

&nautilus; file manager may display your action in different places, depending on what you will request here, and if some item is currently selected (or not).

Click on the Action tab to show the page which will permit you to configure the locations your action targets.

## Targeting the selection context menu

When Display item in selection context menu is checked, then your action will be a candidate to be displayed in &nautilus;' context menu as soon as at least one item is selected in the file manager. Your action will so deal with currently selected item(s).In order to be actually displayed, all the conditions defined in your candidate action must be met by each item currently selected in the &nautilus; file manager.

When an action targets the selection context menu, and is actually displayed in &nautilus;' context menu, then it is also displayed in &nautilus;' Edit menu.

This target is checked by default.

## Targeting the location context menu

When Display item in location context menu checkbox is activated, then your action will be a candidate to be displayed in &nautilus;' context menu when the file manager selection is empty. Your action will so deal with currently displayed location. In order to be actually displayed, all the conditions defined in your candidate action must be met by the location currently displayed in the &nautilus; file manager.

When an action targets the location context menu, and is actually displayed in &nautilus;' context menu, then it is also displayed in &nautilus;' File menu.

## Targeting the toolbar

When Display item in the toolbar checkbox is activated, then your action will be a candidate to be displayed in &nautilus;' toolbar.

Actions displayed in the toolbar only deal with the location which is currently displayed in the file-manager, not with the items which may be currently selected (or not). In order to be displayed, all the conditions defined in your candidate action must so be met by the current location.

## Notes

### If your action is to be displayed in a context menu

Whether it is the selection context menu or the location context menu, and both in &nautilus;' context menus and in File or Edit menus, it will be displayed as

- the Context label as a label,

- the Icon,

- these two properties being associated with the Tooltip.

Depending of the exact configuration of your desktop environment, the icon may or may not be displayed in front of the label in the menu.

You may embed some parameters in the label, the icon name or the tooltip. These parameters will be dynamically substituted at runtime with values which will depend on currently selected item(s).

### If your action is to be displayed in the toolbar

It will be displayed as

- the Toolbar label as a label,

- the Icon,

- these two properties being associated with the Tooltip.

Depending of the exact configuration of your desktop environment, the toolbar label may or may not be displayed in front of the icon in the toolbar.

The toolbar label defaults to the same label as those used in menus. By unchecking the Use same label for icon in the toolbar checkbox you can define a label specific to the toolbar, which is usually shorter that those defined for the menus.

You may embed some parameters in the toolbar label, the icon name or the tooltip. These parameters will be dynamically substituted at runtime with values which will depend on currently selected item(s).

### Defining several targets

An action may target the selection context menu, the location context menu and the toolbar, or one or more of these.

### Defining no target at all

If no target is defined, i.e. if the three checkboxes are unchecked, then your action will never be displayed.