Menus Configuration¶
In this section you will learn how to configure the menus globally, per organization/website, or for your own use only. You also will learn the various kinds of menus in OroCommerce and OroCRM management console and OroCommerce storefront.
Menu Types Overview¶
Navigation Bar¶
The application_menu is the main menu of the Management Console in Oro application. It resides on the top of every application page and you can use it to navigate through Oro application. Subject to configuration, it may be displayed horizontally or vertically. To toggle the way it is displayed, navigate to the System > Configuration section using the main menu, and open System configuration > General Setup > Display Settings in the panel to the left. In the Navigation Bar section, unselect the Use Default option and select the Top or Left position.
In the latter case, the menu items are displayed as icons. For more information, see Main Menu.
In a top position, Application Menu (Navigation Bar) looks like a top menu with a drop-down sub-menus that expand once you hover over the parent item:

In a left position, Application Menu (Navigation Bar) may be collapsed into the icon bar:


or expanded for visible labels and sub-menu items:


Shortcuts¶
You can find shortcuts menu in the top panel of the application, next to the organization name.



It helps you pin the frequently used actions and have them handy. You can launch an action by clicking it in the dynamically generated Most Used Actions list. This list is updated as you are using the system, and will initially contain the actions that you use the most.
To access other shortcuts, click See the full list to see complete list of shortcut items or use search: start typing the name of a related entity or an action to choose from a list of matching items.



User Menu¶
In Management Console, user can access their profile configuration, emails, tasks and events via a usermenu (by clicking on your name on the top right of the application).



Calendar Menu¶
A calendar_menu is a service menu that is used on the My Calendar page and helps to change the displayed calendar color, hide or remove a calendar.


Permissions Required to Customize Menus¶
The ability to configure menus globally, per organization, and for personal use is controlled by the two capabilities: Manage Menus and Access system configuration.
By default, only users with Admin role have these capabilities enabled and may customize menus on all configuration levels.
To enable a user to personalise menus for themselves and configure menus for each organization individually, include the Manage Menus capability into the user role.
To enable a user to configure menus globally, for all organizations, websites, and users whose configuration fall back to the global settings, both Manage Menus and Access system configuration capabilities should be enabled for the user role.
Menu Configuration Levels¶
In Oro applications, you can manage the way menus look and the elements they contain on the multiple configuration layers:
OroCRM and OroCommerce Management Console
- Customize Default Management Console Menus (global, system configuration)
- Customize Management Console Menus per Organization
- Customize Management Console Menus for Your Own Use
Customize Default Management Console Menus¶
To customize one of the default management console menus (e.g. navigation bar or user menu):
- Navigate to the management console menu list by clicking System > Menus in the main menu.
- Click on the menu you would like to edit.
- Update the menu contents following the guidelines provided in the Customize a Menu section. The changes apply automatically.
Customize Management Console Menus per Organization¶
Note
This option is available in the Enterprise edition only.
To customize one of the management console menus (e.g. navigation bar or user menu) for a particular organization:
- Navigate to the management console menu list by clicking System > User Management > Organizations in the main menu.
- Click on the organization you would like to edit the menu for.
- Click Edit Menu.
- Update the menu contents following the guidelines provided in the Customize a Menu section. The changes apply automatically.
Customize Management Console Menus for Your Own Use¶
To customize one of the management console menus (e.g. navigation bar or user menu) for your own use:
- Click on your name at the top right of the page and then click My User to open your profile.
- Select Edit Menus from the More Actions list at the top right of the page.
- Update the menu contents following the guidelines provided in the Customize a Menu section. The changes apply automatically.
Menu Management¶
On various configuration levels, the menu and frontend menu list looks the same and the flow for customizing any menu is similar.
On the menu list you can see the menus available for review or customization.



Generic Principles¶
A menu may be multi-level like, for example, a default OroCRM and OroCommerce Management Console main menu. The child menu items are nested under parent menu items (e.g. Accounts, etc are nested under the Customers).



Menu items on the same level of hierarchy may be visually separated by a divider that looks like a horizontal line.



Dividers help you logically organize menu items.
Edit a Menu¶
To view and edit menu contents, click on the menu name or on the View icon in the corresponding row of the menu list.



On the page that opens, the menu item tree is shown in the left panel. Center is reserved for the menu item configuration.



Toggle the Menu Tree View¶
Hide / Show the Menu Tree¶
To minimize or maximize the left menu panel, click a double arrow on the top right of the panel.


Expand / Collapse a Menu Tree¶
To expand / collapse a parent menu item, click an arrow in front of it.


To expand / collapse all menu items, click the ellipses drop-down menu on the top right of the left panel and click Expand All or Collapse All.


Rearrange Menu Items / Dividers¶
You can change the position of an item / divider in a menu by dragging and dropping it in the left panel. You can change the order of menu items at the same level as well as move an item / divider to the higher or lower level.
When you drag-and-drop items, pay attention to the arrow that shows where the item will be placed:
If an arrow points to the place between items, that is where the moved item will be placed.
If and arrow appears in front of a menu item, then the moved item will become a child of the item that the arrow points to.
Add a Menu Item¶
In the left panel, click a menu item which will be parent for the menu item that you create.
Click Create drop-down on the top right and click Create Menu Item on the list.
The created menu item will appear as the last one on the list of children of the same parent item. You can move it to the position that you need, as described in the Rearrange Menu Items / Dividers action description.
In the right part of the page, specify the following information:
Title—A name for the menu item. This is how this menu item will be represented in the menu.
Click the Translations icon to provide spelling for different languages. Click the Default Language icon to return to the single-language view.
URI—An web address of the page or resource that this menu item opens.
You can specify an absolute URI or one relative to the application URI (as specified in Application Settings in System Configuration).
If this menu item serves as a non-clickable parent that does not link itself to any resource (like Customers in the default main menu), type #.
Icon—From the list, select the icon that will denote the menu item.
Note
Sometimes menus (or menu levels) may not be supposed to display icons. For example, icons added to the first level of the main menu (application_menu) are displayed only when this menu is set to appear on the left.
Description—Type a short but meaningful description of the menu item.
Click the Translations icon to provide spelling for different languages. Click the Default Language icon to return to the single-language view.
Click Save to save your changes. If you wish to start creating another menu item right away, click Save and New on the top right.
Important
You need to reload the page to see changes.
Add a Divider¶
- In the left panel, click a menu item which will be parent for the menu divider that you create.
- Click Create drop-down on the top right and select Create Divider.


The created divider will appear as the last one on the list of children of the same parent item. You can move it to the position that you need, as described in the Rearrange Menu Items / Dividers action description.
Important
You need to reload the page to see changes.
Note
Some menus (or some menu levels) cannot display dividers. For example, if you add a divider to the first level of the main menu (application_menu), this divider will not be displayed.
View / Edit a Menu Item¶
- In the left panel, click a menu item that you want to view / edit.
- In the right part of the page, review / edit the menu item settings. See step 3 of the Add a Menu Item action description for information about menu item fields.
Important
You cannot edit URI for default menu items.
Toggle Item Visibility¶
Hide a Menu Item¶
If you do not want one of the default menu items to be visible on the interface, you can hide it.
Important
- If a menu that you hide has child items, they will be hidden too.
- You cannot hide non-default menu items.
To hide a menu item, perform the following steps:
- In the left panel, click a menu item that you want to hide.
- Click Hide on the top right.
Important
You need to reload the page to see changes.
Show a Menu Item¶
To show a previously hidden menu item, perform the following steps:
- In the left panel, click a menu item that you want to show.
- Click Show on the top right.
Note
If a menu item that you want to show has a parent, it will become visible too.
Important
You need to reload the page to see changes.
Find a Menu Item¶
To quickly find a menu item, enter its name into the search field and click the Search icon, or press Enter.


Delete a Menu Item / Divider¶
Important
- You cannot delete default menu items.
- When you delete a menu item that has child items, they will not be deleted but moved to the parent of the menu item that you delete.
- In the left panel, click a menu item / divider that you want to delete.
- Click Delete on the top right.
- In the Delete Confirmation dialog box, click Yes, Delete.
Important
You need to reload the page to see changes.
Reset a Menu¶
To reset any customization changes and roll back to the menu that is provided out of the box in Oro application:
- In the left panel, click a menu name.
- Click Reset on the top right.
- In the Reset Confirmation dialog box, click Yes, Reset.
Important
You need to reload the page to see changes.
Related Topics¶
- Customize a Menu in the Developer Guide
- How to Create and Customize the Application Menu