Skip To Content

Customize the ribbon options

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

To open the Customize the Ribbon options, 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 for your convenience 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

ComponentDescription
1

The Choose commands from drop-down list. Commands that you want to add to new groups can be selected from their current locations on the ribbon (List of Tabs) or from an alphabetical list (All Commands). Geoprocessing tools are found on their own list (Geoprocessing Tools).

2

By default, commands are presented in the left-hand window in the List of Tabs format. To access a command, expand the tabs and groups on which it is found and then select the command.

3

The current configuration of the ribbon is presented in the right-hand window. This is where new groups and new tabs are added.

4

Buttons to add and remove commands.

5

Buttons to add new tabs and groups, and to rename tabs and groups.

6

Drop-down menu choices to reset customizations.

7

Button to assign accelerators (keyboard shortcuts) to commands.

8

Check box to show command IDs.

Ribbon customization elements

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 that you want to add a group to.
  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 group is selected.

    A new group is added under the other groups on the tab. Its default name is New Group.

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

    If you choose All Commands or Geoprocessing Tools, a search box becomes available 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.
  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:

    If you add more than one command to a group, you can change the display order of commands with the arrow buttons on the right side of the dialog box.

  10. Click OK.

    The Options dialog box closes.

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

    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 New Tab.

    A 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 group. On the ribbon, the new tab will appear to the right of other core tabs.

    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 contexts. New tabs cannot be added to contextual tab groups.

  3. With the new tab selected, click Rename. On the Rename dialog box, replace the default name with the name you want. Click OK.
  4. Under the new tab, click New Group 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 add commands to.
  6. In the Choose commands from drop-down list, accept the List of Tabs 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. In the same way, 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.

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

Remove ribbon customizations

You can remove your customizations as needed.

Remove commands, groups, or tabs

You may want to remove a command that you added to a new group. You may want to remove a group that you added to an existing tab or to a new tab. Or you may want to remove a new tab that you added.

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

    A command selected for removal from a custom group
    In this example, a command is removed from a group.

    Note:

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

Reset customizations

Use the Reset button to remove all customizations from a selected tab or to remove all customizations 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.

    A 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.

    Tip:

    To remove all customizations from the ribbon, click Reset All. This restores the ribbon to its default configuration.

Use keyboard accelerators

You can use keyboard accelerators, also called keyboard shortcuts, to execute a command with a keystroke combination or function key.

Add a keyboard accelerator

You may want to add keyboard accelerators to commands you use frequently.

  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. Under Accelerator, 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 new 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 or an accelerator that you added), a message will appear and identify the command the accelerator is currently assigned to. You can choose whether to override the assignment.

Remove a keyboard accelerator

You may want to remove an accelerator if you don't use it.

  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 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 easy 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 either scrolling window, right-clicking the command, and clicking Copy ID to clipboard.

Related topics