How To Access

  1. Select Menus → [name of the menu] → Add New Menu Item from the drop-down menu on the back-end of your Joomla! installation. For example, if a Menu is called "About Joomla", select Menus → About Joomla → Add New Menu Item.
  2. Or navigate to Menu Manager: Menu Items and click on the "New" icon in the toolbar.


Menu items are the core structure of a Joomla website. Each Menu Item is a link to a webpage. The Menu Item Type determines the type of page that will display when this menu choice is selected by the User. The core distribution of Joomla provides 29 different Menu Item types. If you install third-party extensions, these may add more menu types.

In this screen, you will select the Menu Item Type for the Menu Item you are creating and then fill in information about this specific Menu Item. Some of these fields are common to all Menu Item types. These include the following sections: Details, Link Type Options, Page Display Options, Metadata Options, and Module Assignment for this Menu Item. These common fields are documented in this help screen.

In addition to these common fields, different Menu Item types may require different fields unique to that type. These are documented in the help screen for each type.


Help25-Menu Item New Type.png

Note: If you install one or more Joomla! extensions, these extensions may add new Menu Item Types. In this case, your list will have additional types.

Column Headers


The left side of the screen contains the Details section. This section is the same for all menu item types and has the following fields.

Click on the link for the desired type to select that type. Note that more types may be available if you install third-party components.
When the menu item type is selected, the modal window will close and the Menu Item Type field is filled in automatically. When the screen redisplays, the available options on the right side of the screen will vary depending on which type is selected. The Details section, on the left, and the Link Type Options, Page Display Options, Metadata Options, and Module Assignment for this Menu Item, will show for all menu item types. Other options specific to the selected type may also be available.

Default Page. If Yes, this menu item is the default or home page for the site. There must be exactly one menu item set as the default page. You can change the default page in two ways:

  1. Click on the Home column of the desired menu item in the Menu Manager: Menu Items screen.
  2. Open the menu item for the new default page and change the Default Page setting to Yes.

Link Type Options

This layout has the following Link Type Options.


These let you control attributes of the link for this menu item in the Joomla menu.

Page Display Options

This layout has the following Page Display Options.


Metadata Options

This layout has the following Metadata Options.

  1. To help Search Engines and other systems classify the content of the Article.
  2. In combination with Banner tags, to display specific Banners based on the Article content. For example, say you have one Banner with an ad for dog products and another Banner for cat products. You can have your dog Banner display when a User is viewing a dog-related Article and your cat Banner display for a cat-related Article. To do this, you would:
    1. Add the keywords 'dog' and 'cat' to the appropriate Articles.
    2. Add the Tags 'dog' and 'cat' to the appropriate Banners in the Banner Manager New/Edit screen.
    3. Set the Banner module Parameter 'Search By Tags' to 'Yes in the Banner Module Edit screen.
  3. For articles only, in combination with the Related Articles module, to display Articles that share at least one keyword in common. For example, if the current Article displayed has the keywords "cats, dogs, monkeys", any other Articles with at least one of these keywords will show in the Related Articles module.

Module Assignment for this Menu Item

This part of the screen gives you access to a list of the site's modules as shown below.


If you click on a module name, a modal window is opened with the same format as when you add or edit a module in Module Manager. For example, clicking on Archived Articles opens a modal window as shown below.


Using this modal window, you can assign the module to this or any other menu item and also enter the module's position and other options.

The Display column indicates whether this module will display on this menu item. Note that this column is not updated until you save the menu item.

Quick Tips


At the top right you will see the toolbar:


The functions are:

Related Information