Customize the ribbon options

You can customize the ArcGIS Pro ribbon by creating tabs and choosing which commands appear on them. You can also add new groups and commands to existing tabs.

The Customize the Ribbon options are accessed from the ArcGIS Pro Settings page. To open them, follow these steps:

  1. From an open project, click the Project tab on the ribbon. Or, from the ArcGIS Pro start page, click Settings in the lower left corner.
  2. In the list on the left, click Options.
  3. On the Options dialog box menu, under Application, click Customize the Ribbon.

Add tabs, groups, and commands to the ribbon

You can organize functionality by adding commands to new groups on existing ribbon tabs or new tabs. At any time, you can remove specific customizations or reset the ribbon to its default state.

Customize the Ribbon dialog box

Add groups and commands

The most common way to customize the ribbon is to add commands to a new group on an existing tab.

  1. Open the Customize the Ribbon options as described above.
  2. In the scrolling window on the right, representing the current ribbon configuration, browse to the tab to which you want to add a group.
  3. Select the tab. Optionally, expand the tab to see its groups.
  4. Click New Group.

    Selected tab and New Group button
    In this example, the Appearance tab on the contextual Feature Layer tab set is selected.

    A new group named New Group (Custom) is added under the other groups on the tab.

  5. With New Group (Custom) selected, click Rename.
  6. On the Rename dialog box, replace the display name, and click OK.
  7. In the Choose commands from drop-down list, accept the Popular Commands setting. Alternatively, click the drop-down arrow and choose All Commands, List of Tabs, Popular Geoprocessing Tools, or All Geoprocessing Tools.
    Tip:

    If you choose All Commands or All Geoprocessing Tools, a search box appears to help you find commands.

  8. In the scrolling window of commands, browse to or search for the command you want to add.
    Tip:

    Widen the Options dialog box to see the full command names. Hover over a command to see its ToolTip.

  9. Select a command and click Add.

    Properties command added to the new group
    In this example, the command to open layer properties is added to a new group named Properties.

    Tip:

    Use the arrow buttons on the right side of the dialog box to change the order of groups on a tab or the order of commands in a custom group. You cannot change the order of commands in built-in groups.

  10. Click OK.

    The Options dialog box closes.

  11. Return to your project or open a project. Click the tab to which you added the new group.

    The group and its commands appear on the tab.

    Appearance tab on the ribbon with the custom Properties group and Layer Properties button
    In this example, layer properties can be opened from the contextual Appearance tab.

Add a new tab

You can add a new tab to the ribbon to organize commands that are not grouped on the ArcGIS Pro interface by default.

  1. Open the Customize the Ribbon options.
  2. Under the scrolling window on the right (the current ribbon configuration), click the New Tab drop-down arrow and click New Tab.

    New tab added to the list of ribbon tabs

    In the window, a new tab and new group are added under the other core tabs, above the first contextual tab set. On the ribbon, the new tab appears to the right of other core tabs by default.

    Note:

    You can place a new tab in a different position by selecting an existing tab before adding the new tab. However, this is not recommended because the new tab may not appear in the expected position in all situations.

  3. With the new tab selected, click Rename. On the Rename dialog box, replace the default name, and click OK.
  4. Under the new tab, click New Group (Custom) to select it. Rename the new group.
  5. Select the new tab. Add new groups as needed and rename them. When you're finished, select a group to which to add commands.
  6. In the Choose commands from drop-down list, accept the Popular Commands setting or click the drop-down arrow and make a different choice.
  7. In the scrolling window of commands, browse to or search for a command. Select the command and click Add.
  8. Add more commands to the group, and add commands to other groups on the tab. When you're finished, click OK.

    The Options dialog box closes.

  9. Return to your project or open a project to see the customization.

    Custom tab on the ribbon
    A new tab named Convert is added to the ribbon.

Add a new contextual tab

Contextual tabs appear on the ribbon when the application is in a particular state. Contextual tabs are associated with a tab set (a grouping of one or more contextual tabs). Several contextual tabs may be associated with the same tab set; however, contextual tabs appear only as needed and may or may not appear with other contextual tabs. For example, if you enable time on a map layer, the Map tab set appears on the ribbon with the contextual Time tab under it. If you add a graphics layer to the map, the contextual Graphics tab also appears under the Map tab set. If you remove the time-enabled layer, the Time tab disappears.

  1. Open the Customize the Ribbon options.
  2. In the scrolling window on the right (the current ribbon configuration), scroll down past the tabs listed under Main Tabs to the list of contextual tab sets.

    Each bold heading is a tab set. Each contextual tab under the heading is associated with the tab set.

  3. Under a tab set, click a contextual tab with which your new tab will be grouped.

    For example, to add a contextual tab that appears with the contextual Time tab, click the Time tab under Map. The new contextual tab may include geoprocessing tools for working with time fields.

    Note:

    A custom contextual tab must be grouped with a built-in contextual tab. On the ribbon, it always appears next to this built-in tab. It cannot appear by itself under a tab set.

  4. Under the scrolling window, click New Tab and click New Tab with Context.
    New contextual tab added to the list of ribbon tabs

    In the window, a new tab and new group are added under the contextual tab set.

  5. With the new tab selected, click Rename. On the Rename dialog box, replace the default name, and click OK.
  6. Under the new tab, click New Group (Custom) to select it. Rename the new group.
  7. Optionally, select the new tab and add more groups. When you're finished, select a group to which to add commands.
  8. In the Choose commands from drop-down list, accept the Popular Commands setting or click the drop-down arrow and make a different choice.
  9. In the scrolling window of commands, browse to or search for a command. Select the command and click Add.
  10. Optionally, add more commands to the group, and add commands to other groups on the tab.

    Custom contextual tab with a custom group that contains two geoprocessing tools

  11. When you're finished, click OK.

    The Options dialog box closes.

  12. Return to your project or open a project to see the customization.

    Custom contextual tab on the ribbon
    In this example, a custom contextual tab with geoprocessing tools appears with the built-in contextual Time tab.

Remove commands, groups, and tabs from the ribbon

You can remove custom commands, groups, or tabs that you have added to the ribbon. You can also hide built-in and custom tabs.

Remove custom commands, groups, and tabs

  1. Open the Customize the Ribbon options.
  2. In the scrolling window on the right (the current ribbon configuration), browse to and select a custom tab or group, or a command that you added to a custom group.
  3. Click Remove. Alternatively, right-click the selected item and click Remove.

    Group selected for removal from a custom tab
    In this example, a group is removed from a custom contextual tab.

    Note:

    Removing a group also removes its commands. Removing a tab also removes its groups.

  4. Click OK.

Hide tabs

You can hide built-in and custom tabs to simplify the user interface. Hidden tabs are not shown on the ribbon but are not removed from the Customize the Ribbon options. It is not possible to remove built-in tabs.

  1. Open the Customize the Ribbon options.
  2. In the scrolling window on the right (the current ribbon configuration), uncheck the check boxes next to any tabs that you want to hide.
  3. Click OK.

    The tabs no longer appear on the ribbon. To show them again, open the Customize the Ribbon options and check their check boxes.

Export and import customizations

You can import and export your ribbon customizations to use on different computers or to share with others.

Export customizations

If you have customized the ribbon or the Quick Access Toolbar, you can export the customizations to a file.

  1. Open the Customize the Ribbon options.
  2. Click Import/Export and click Export customizations.
  3. On the ArcGIS Pro Customizations dialog box, browse to the folder where you want to save the file.
  4. In the File name text box, type a name for the file or accept the default name.
  5. Click Save.

    The customization file is saved with the .proExportedUI file extension. Other users can import it to apply the customizations to ArcGIS Pro on their computers.

Import customizations

You can import ribbon customizations from a .proExportedUI file.

  1. Open the Customize the Ribbon options.
  2. Click Import/Export and click Import customization file.
  3. On the ArcGIS Pro Customizations dialog box, browse to the folder that contains the customization file. Select the file and click OK.

    A prompt asks if you want to replace all existing ribbon and Quick Access Toolbar customizations.

    Caution:

    Any current customizations will be lost when you import the file. Click No if you want to keep your current customizations.

  4. On the prompt, click Yes.
  5. Click OK on the Options dialog box.

    The customizations specified in the file are applied to the ribbon.

Reset customizations

Use the Reset button to remove all customizations from a selected tab or from the ribbon.

  1. Open the Customize the Ribbon options.
  2. In the scrolling window on the right (the current ribbon configuration), browse to a customized tab and select it.
  3. Next to Customizations, click the Reset drop-down arrow and click Reset Selected Item.

    Selected tab with the Reset Selected Item command highlighted
    In this example, the custom Properties group will be removed from the Appearance tab. If there were other custom groups on the tab, they would also be removed.

    All customizations of the selected tab are removed and the tab is restored to its default configuration. Customizations to other tabs are not affected.

    Note:

    To remove all customizations from the ribbon, including customizations imported from a file, click Reset All. This restores the ribbon to its default configuration. Customizations to the Quick Access Toolbar must be reset in the Quick Access Toolbar options.

Use keyboard accelerators

A keyboard accelerator executes a command with a keystroke combination or function key.

Add a keyboard accelerator

Keyboard accelerators can be added for most commands. However, some commands, such as menus, split buttons, and tool palettes, are selectors that require user interaction to complete. Selector commands are indicated by icons. They can be added to the ribbon or Quick Access Toolbar but cannot be controlled by keyboard accelerators.

List of commands in Customize the Ribbon options
Selector commands are indicated by icons.

  1. Open the Customize the Ribbon options.
  2. In the scrolling window on the left (the list of commands), browse to, or search for, a command and select it.
  3. In the Accelerator text box, type a keystroke combination and click Assign.

    Keyboard accelerator assigned to a command
    In this example, the accelerator Alt+L is assigned to the command that opens layer properties.

  4. Click OK.
  5. Return to your project or open a project to use the accelerator.

    The accelerator only works in appropriate contexts. For example, an accelerator that opens layer properties only works if a map view is active and a layer is selected in the Contents pane.

    Note:

    • If you enter a keystroke combination that is already assigned to another command (either an ArcGIS Pro default accelerator or one that you added), a message appears identifying the command to which the accelerator is currently assigned. You can choose whether to override the assignment.
    • You can only use the Shift key in an accelerator when it is combined with a function key (for example, Shift+F6) or a special key, such as an arrow key (for example, Shift+Up arrow). This constraint prevents accelerators from conflicting with text input of capital letters.

Remove a keyboard accelerator

You can remove accelerators.

  1. Open the Customize the Ribbon options.
  2. In the scrolling window of commands on the left, select a command that has an accelerator assigned to it.
    Note:

    If a command has an accelerator, the keystroke combination appears in the Accelerator text box when the command is selected. Otherwise, the box is empty.

  3. Click the Assign drop-down arrow and click Reset.

    The accelerator is removed from the Accelerator box.

    Tip:

    To remove all custom accelerators, click the Assign drop-down arrow and click Reset All Accelerators. ArcGIS Pro default accelerators are not affected.

Show command IDs on ScreenTips

Every command has a unique text ID, which is used by add-in developers to find or call commands. For quick reference, the command ID can be displayed in the command's ScreenTip on the ribbon.

  1. Open the Customize the Ribbon options.
  2. Check the Show command IDs on ScreenTips check box.
  3. Click OK.
  4. Return to your project or open a project. Hover over a command on the ribbon to display its ScreenTip.

    Command ID displayed in the ScreenTip for the Tools button on the Analysis tab

    To stop displaying command IDs, uncheck the Show command IDs on ScreenTips check box in the Customize the Ribbon options.

    Tip:

    You can also get the command ID by browsing to a command in the scrolling window on the right, right-clicking the command, and clicking Copy ID to clipboard. (You can use the scrolling window on the left only if you set the Choose commands from drop-down list to List of Tabs.)

Related topics