How to Create Tabs in Joomla 5 and Joomla 6

Learn how to create horizontal or vertical tabs in Joomla 5 and 6, when tabs are useful, and how to build reusable tab layouts from Joomla Articles or manual content.

Tabs are useful when several closely related pieces of content belong on the same page but do not need to be visible at the same time. They work especially well for product specifications, service descriptions, documentation sections, pricing explanations and other compact content groups.

This guide explains the practical ways to create tabs in Joomla 5 and Joomla 6 and how to decide between horizontal tabs, vertical tabs and an accordion layout.

How to create horizontal and vertical tabs in Joomla

When are tabs a good fit?

Tabs work best when the visitor benefits from switching between related sections without leaving the current page.

Typical examples include:

  • Overview / Features / Compatibility;
  • Installation / Configuration / Troubleshooting;
  • Monthly / Annual pricing information;
  • Specifications grouped by topic;
  • Content for several related audiences;
  • short documentation sections.

If every section is important to read in sequence, a normal document may be clearer. If the page is very narrow or the labels are long, an accordion may be easier to use.

Horizontal tabs vs vertical tabs

Horizontal tabs

Horizontal tabs place the tab labels in one row above the active content panel.

They work well when:

  • there are only a few tabs;
  • the labels are short;
  • the content area is reasonably wide;
  • visitors are familiar with the sections.

Vertical tabs

Vertical tabs place the tab list beside the active panel.

They are useful when:

  • tab labels are longer;
  • you have several related sections;
  • the page has enough horizontal space;
  • you want the section labels to remain visible as a clear list.

Keep tab labels short and meaningful

A tab label should tell the visitor what is inside without needing extra explanation.

Good:

Overview
Features
Compatibility
FAQ

Less useful:

More Information
Other Details
Additional Content
Click Here

Short labels also behave better on tablets and narrow module positions.

Do not hide unrelated content inside tabs

Tabs should group content that belongs together. They should not be used simply to make a page shorter.

If the sections represent unrelated topics, separate pages or normal headings may provide clearer navigation and stronger internal linking.

Create reusable tabs with ES Content Display

ES Content Display supports both Horizontal Tabs and Vertical Tabs.

You can build the tab content from either:

  • Manual Items entered directly in the module; or
  • existing Joomla Articles.

Option 1: Create tabs with Manual Items

Manual Items are useful when the content belongs only to this tabbed block.

  1. Create an ES Content Display module.
  2. Set Content Source to Manual Items.
  3. Add one item for each tab.
  4. Give each item a clear Title.
  5. Add the Intro and/or Body content.
  6. Choose Horizontal Tabs or Vertical Tabs as the Display Layout.
  7. Publish the module.

The item Title becomes the tab label and the configured content becomes the active panel.

Option 2: Create tabs from Joomla Articles

If the content already exists as Joomla Articles, keep the Articles as the source of truth.

For example:

Category: Product Documentation

Articles:
Overview
Installation
Configuration
Troubleshooting

Create an ES Content Display module, choose Joomla Articles as the source, filter the collection, and then select a Tabs layout.

This avoids copying Article content into a separate tab editor.

Filter the Articles before choosing the tab layout

The content source and the visual layout are separate decisions.

You can define the Article collection by:

  • Category;
  • Tags;
  • Featured state;
  • Language;
  • Ordering;
  • Article limit.

Once the correct collection is selected, choose the tab presentation.

For a deeper look at collection filtering, see How to Display Joomla Articles by Category or Tag.

Keyboard accessibility matters

Tabs are interactive controls, not just styled links.

A good tabs implementation should provide a predictable keyboard pattern and expose the active state to assistive technology.

ES Content Display uses manual tab activation:

  • Horizontal Tabs: Left / Right Arrow moves focus;
  • Vertical Tabs: Up / Down Arrow moves focus;
  • Home moves to the first tab;
  • End moves to the last tab where applicable;
  • Enter or Space activates the focused tab.

What should happen on narrow screens?

A horizontal tab row can become difficult to use if the module is narrow.

ES Content Display can adapt tab layouts to an Accordion when the module becomes narrow, or you can keep the Tabs presentation when that better fits the content.

Test the actual module width, not only the browser width. A module inside a sidebar can be narrow even on a large desktop display.

Deep-link directly to a tab

For documentation and support pages, it is useful to link directly to a specific tab.

ES Content Display supports stable module-scoped deep links for tab items. When a valid URL hash is opened, the corresponding tab is activated.

This is useful for:

  • support replies;
  • documentation links;
  • internal navigation;
  • sharing a specific configuration section.

Tabs or accordion?

Use Tabs when the visitor benefits from seeing the available sections side by side and switching between them.

Use an Accordion when:

  • the layout is narrow;
  • there are many items;
  • the labels are long;
  • vertical scrolling is more natural.

See How to Create an Accordion in Joomla for the alternative pattern.

Frequently asked questions

Can I create Joomla tabs from existing Articles?

Yes. ES Content Display can use Joomla Articles as the source and render the selected collection as Horizontal or Vertical Tabs.

Can I create tabs without creating Joomla Articles?

Yes. Use Manual Items when the content belongs only to the tabbed display.

Can tabs change into an accordion on mobile?

Yes. ES Content Display can adapt the tab presentation when the module becomes narrow.

Can I link directly to one tab?

Yes. Deep Links can activate the matching tab when a valid item hash is opened.

Summary

Tabs are a good choice for several closely related sections that belong on one page. Keep labels short, use a predictable keyboard interaction pattern, and choose the content source separately from the visual layout.

See the ES Content Display documentation for Horizontal Tabs, Vertical Tabs, deep links and responsive behavior.