Skip to content
Tutorials Center
My learning

Topics

Lesson 16 of 37 ยท Menus and Modules

Menu Item Types in Joomla

Learn the main Joomla menu item types: single article, category blog and list, featured, tagged items, contacts, login, and system links, and when to use each.

When you create a menu item, the first decision is its type. The type picks the component and the view, and therefore what the page looks like and how its URL behaves. Joomla offers dozens of types, grouped by component; most sites use perhaps ten of them. This lesson walks through the ones you will meet most often and shows the internal link each one produces.

The backend is described in words. The stand-in builds the internal links for several types so that you see how types map to components and views.

Choosing a type

Press New in a menu, then Select next to Menu Item Type. A dialog lists groups: Articles, Contacts, Tags, Users, Smart Search, News Feeds, Banners, Wrapper, System Links, Configuration Manager and others, depending on installed extensions.

Articles

Type What it shows Typical use
Single Article One article About page, contact info, policies
Category Blog Articles of a category as a blog with intro text and Read More News, blog
Category List Articles of a category as a table of titles Document lists, glossary
List All Categories A tree of categories A section index
Featured Articles Articles marked as featured Home page
Archived Articles Archived articles, filterable by date Archive
Create Article A frontend form to submit an article Author submissions

The two most useful are Single Article and Category Blog. Single Article ties a page to exactly one article: changing the article text changes the page. Category Blog is the engine of news sections: each article is shown with its intro; the Layout tab sets how many leading, intro and link items appear, how many columns to use and how they are ordered.

Contacts, Tags, Users

  • Contacts > Single Contact shows a contact with a contact form and details.
  • Contacts > List Contacts in a Category is good for team directories.
  • Tags > Tagged Items and List of All Tags build topic pages.
  • Users > Login Form, Registration Form, Profile, Edit Profile and Password Reset build the member area.

System Links: navigation helpers

URL Any link, such as an external site
Menu Heading A label that holds a submenu
Separator A divider in the menu
Menu Item Alias A second link to an existing item

They create no page of their own

1 / 2
  • URL goes to any address; use Link Type > Target window to open it in a new tab (add rel="noopener" options where offered).
  • Menu Heading holds a submenu without being a page itself, perfect for a drop-down labelled "Services".
  • Separator is a divider or a non-clickable label.
  • Menu Item Alias repeats another item, so the same page can appear in two menus while keeping a single URL and set of options. It inherits the other item's page but can get its own module assignment and Display in Menu setting.

Each item stores an internal link made of an option (component) and a view, plus parameters. For a Single Article it looks like this:

TEXT
index.php?option=com_content&view=article&id=12

The router converts that into the clean path from the alias chain. If you want to see the link of an existing item, open the item and look at the Link field.

JS Stand-in: build internal links for menu item types

Press Run (or Ctrl + Enter) to see the console output here.

No output.

The table of builders models how Joomla stores option, view and the id parameters. You can see that a type decides the component and view while the parameters decide which content is shown.

Settings that differ by type

Each type adds its own options tab:

  • Single Article: choose the article; options to show title, author, dates, navigation arrows, tags and so on.
  • Category Blog: choose category, subcategory levels, leading/intro/link counts, columns, ordering, pagination, and whether to show the category title, description and image.
  • Category List: choose the columns (title, date, author, hits) and filters.
  • Featured Articles: choose which categories to include or exclude.
  • Login Form: after-login and after-logout redirect pages.

The Page Display tab (all types) lets you override the Browser Page Title, show or hide the Page Heading and add a Page Class (a CSS class on the page wrapper for styling).

Choosing wisely

  • A page of mostly static text: Single Article.
  • A growing list of posts: Category Blog (or a Category List for compact tables).
  • A topic hub: Tagged Items.
  • A drop-down group: Menu Heading with children.
  • A link to somewhere else: URL.
  • The same page in two menus: Menu Item Alias.
JS Stand-in: pick a menu item type

Press Run (or Ctrl + Enter) to see the console output here.

No output.

Use it as a checklist when planning a site: for every page in your sitemap write the type next to it.

Common mistakes

  • Using Single Article for a list of posts, then adding a new menu item for every post.
  • Linking to a category with a URL item and losing routing and permissions.
  • Changing the type of an existing item and losing options; recreate it carefully instead.
  • Forgetting that Category Blog items take over sub-paths, so a clash with another item at the same path surprises people.

Check your understanding

Quick check ยท 4 questions

of 4 answered You scored / 4 ยท perfect!

  1. 1. Which type is best for a news section with intro texts and Read More links?

    Category Blog shows the articles of a category with intro text and links to the full articles.
  2. 2. What is a Menu Heading used for?

    A heading has no page of its own; it holds child items.
  3. 3. A Menu Item Alias lets you...

    The alias item points to another item, so you can reuse it in different menus.
  4. 4. What does a menu item type decide?

    Type selects the component, view and layout; parameters select which content.

Summary

  • The menu item type selects the component, view and layout of the page.
  • Single Article, Category Blog, Category List and Featured Articles cover most content pages.
  • Contacts, Tags and Users types build directories, topic pages and member areas.
  • System Links (URL, Menu Heading, Separator, Menu Item Alias) support navigation without creating pages.
  • Plan the type of every page in your site map before building.

Next: Modules and Template Positions