Configuring Menu Displays

Submit Feedback

Use a Menu Display fragment or a Menu Display widget to display and configure a menu display. With either option, you can define the menu display options, levels, and behavior for your site.

Tip

If you are new to Liferay, use the menu display fragment to get started with building your site’s navigation menus. The menu display fragment provides preview options that work with master page templates and ease of configuration that menu display widgets do not provide.

Available 7.4+

You can create a navigation menu anywhere in your content page. This navigation menu is based on your site’s pages hierarchy or any other hierarchy you define using Liferay’s navigation menus application. You can also define the menu display style options and the number of sub-levels to include in the navigation.

The Menu Display fragment appears under the Fragments and Widget section of your content page. You add and configure this fragment as with other fragments in your content pages. For more information, see Adding Elements to Content Pages and Configuring Fragments.

You can build the hierarchy of pages and subpages in the Menu Display fragment using two methods:

Site Navigation Menus (A) uses the menus you define using the Liferay DXP navigation menu for site navigation. By default, Liferay DXP provides two site menus based on the pages hierarchy in your site.
Contextual Menus (B) shows a menu that is based on the page context. For example, you can create a more advanced navigation by combining a first-level Menu Display fragment linked to one of your site menus with a second-level Menu Display fragment that only shows the child pages. This way, when the user clicks through the different pages in the first-level menu, the second-level menu changes dynamically to show the children pages.

Below are all the options possible in the Menu Display widget. To access the configuration menu, click Options () in the Menu Display widget header → Configuration.

Note

Before Liferay DXP 2025.Q1, the Configuration option appeared in the widget’s top-right corner.

Select the desired navigation menu type; the desired navigation menu type appears in the preview box.

Navigation Menu Type	Description
Pages Hierarchy	Pages Hierarchy is based on the default hierarchy in the site builder.
Primary Navigation	Primary Navigation is the main navigation for a page.
Secondary Navigation	Secondary Navigation is a second level of navigation, possibly a sidebar or a separate menu within a page.
Social Navigation	Social Navigation is for menus that contain links for sharing content on social media or similar tasks.

Alternately, you can choose an existing navigation menu by selecting Choose Menu and clicking the Select button (you can choose a navigation menu from a parent site using this option).

Display Templates

You can select a widget template for navigation menus:

Display Template	Description
List Menu	Displays all the items in a vertical list.
Pills Horizontal	Displays the items horizontally and uses a button style for highlighting.
Pills Justified	Like Pills Horizontal, but pads the items to fill out the horizontal space.
Pills Stacked	A vertical version of the pills style.
Tabs	Displays the items like navigation tabs.
Tabs Justified	Navigation tabs that fill horizontal space.
Bar Minimally Styled	A lightweight version of the default display that you see in the embedded menu on your page.
Bar Minimally Justified Styled	Like Bar Minimally Styled with horizontal padding.
Bar Default Styled	The default embedded menu.
Split Button Drop-downs	Displays each item as a button with a drop-down for multiple navigation levels.

You can configure which pages at what level from the menu appear in the widget. You can choose the starting level, how many levels deep to display, and how to display sub-levels.

Field	Description
Start with Menu Items In	Select the type of Level: Level, Level Relative to the Current Menu Item, or Select Parent. Read more about these options below.
Number of Levels	Select the level number to display, from 0 to 4. Level 0 represents the parent page, Level 1 represents the first level child page, and so forth.
Levels to Display:	Select the number of levels to display in the navigation, from 1 down to Unlimited.
Expand Sublevels:	Select Auto or All from this drop-down menu; this determines if hovering the mouse over the navigation reveals navigation levels one at a time automatically or all the levels at once.

These are the three options under the Start with Menu Items In field:

Level: Level 0 starts at the root level and levels 1-4 are for subsequent levels leading up to the current page if any exists. Since it’s not possible to determine which path to follow from there, further levels are not displayed.
Level Relative to the Current: Here, the order is reversed. Level 0 represents the current page and levels 1-4 represent parent levels starting with the immediate parent (1) up to the furthest possible parent page or the root page.
Select Parent: Manually select the page you want to use as your starting point for the menu.