All you need to know about modules and positions in YOOtheme Pro – from controlling their appearance and style to using the page builder above and below the main content.

The Joomla Module Manager is seamlessly integrated into YOOtheme Pro. Modules can be added, edited and deleted directly in the Modules panels without leaving YOOtheme Pro. There are several module positions that can be used to create all kinds of complex layouts.


The Modules panel shows a list of all module positions and their assigned modules. A gray dot next to a module indicates that this module is published on the page shown in the live preview. Hovering a module in the sidebar highlights its representation in the live preview with a blue border. An option to only display modules in the sidebar that are published and visible on the specific page is also available.

Modules panel

To edit a module, simply click on it. A modal with the Edit Modules view from Joomla will open. Here you can change the module's title, content and its options. YOOtheme Pro adds an additional Template tab containing a number of options to control the appearance and style of the module. A Delete button is also available in the upper right corner of the modal.

Add a New Module

In the Modules panel, scroll down to the bottom and click the New Module button to create a new module. A modal with the New Module view from Joomla will open. Alternatively, add a module in the Joomla module manager.

For a more detailed information about modules, refer to the Joomla documentation.

Module Positions

YOOtheme Pro comes with 8 available module positions where any number of modules can be published. Positions which are empty as well as published modules with no content output will automatically collapse, and the layout will adapt accordingly.

Position Description
toolbar-left toolbar-right These positions are located above the theme header. Find the toolbar settings in Layout → Site.
logo logo-mobile These positions can be used instead of the logo set in the Layout → Site settings.
navbar header These are the theme header positions. Find the header and navbar settings in Layout → Header.
mobile This position allows publishing modules in the mobile navigation, i.e. the off-canvas, modal or dropdown menu. Find the mobile header settings in Layout → Mobile.
sidebar This position allows publishing modules next to the main system output, e.g. a blog or a shop but not pages built with the YOOtheme Pro page builder. Find the sidebar settings in Layout → Sidebar.
These positions allow publishing modules above and below the main system output, e.g. a blog, a shop or a static page. Find the top and bottom settings in Layout → Top and in Layout → Bottom.
builder-1 to builder-6 These positions are reserved for the Position element in the YOOtheme Pro page builder. They are not rendered anywhere else in the theme.

Instead of using the menu positions, you still can publish a menu module in the Navbar or Mobile module position.

Widget areas

Toolbar and Header

The toolbar-left, toolbar-right, navbar and header positions are perfect for publishing a single line of text, a search, a language switcher, a shopping cart, different menus or social icons in the header of your website. Multiple modules are displayed next to each other in a row.

Logo and Logo Mobile

YOOtheme Pro offers an easy way to add all required standard logos to your site. For advanced use cases, for example when displaying different logos on different pages or for different languages, use the logo and logo-mobile positions.

The sidebar position is not rendered on static pages built with the YOOtheme Pro page builder, even if a module is published in the sidebar. This is because the page builder allows building full-width sections where the sidebar needs to be placed within the layout of these sections. This can be done using the Position element in the page builder. Each Position element has its own settings. This allows you to have separate sidebar layouts on different pages. Modules published in the sidebar position will stack above each other.


The mobile position is only shown if the mobile header layout is enabled. It will show up in the modal, dropdown and offanvas modes when you click on the menu toggle. All modules published in the mobile module position will be stacked above each other under the mobile menu.

Top and Bottom

Modules published in the top or bottom position are displayed in a horizontal grid. By default, the modules fill up the available space evenly. For example, when publishing two modules, each of them will automatically use 50% of the available space. It's possible to create complex module layouts. Just set a different width for each module using the Width option in the module's settings. The breakpoint from which modules will stack above each other is set for medium device font-size, like tablets.

Important Publishing modules directly in the top or bottom position may suffice for simple use cases. Using a Builder Module instead will offer advanced possibilities and allow you to create more complex module layouts.

Builder 1 to 6

There are six builder-1 to builder-6 positions which are not rendered anywhere else in the theme. They are reserved to be used by the Position element from the page builder.

Module Settings

YOOtheme Pro adds a Template tab to the Joomla module settings with additional options. The availability of certain settings depends on the position where the module is published and its type.

Module settings

Note Mind that the following settings are ignored if the module is published using the YOOtheme Pro module element. This is because these settings are available in the element itself.

Default Options

Use this default option to style your modules published in any position.

Option Description
Visibility Display the module only on a specific device width and larger.

Default options

Appearance Options

Use these appearance settings to style your modules published in the sidebar, mobile, top and bottom positions.

Option Description
Style Define whether the module looks like a card or whether the style is blank.
Title Style Title styles differ in font-size but may also come with a predefined color, size and font.
Title Decoration Decorate the title with a divider, bullet or a line that is vertically centered to the heading.
Alignment Center, left or right align the text.
Alignment Breakpoint Define the device width starting from which the alignment will apply.
Alignment Fallback Define an alignment fallback for device widths below the breakpoint.

Appearance options

Grid Options

Use these grid settings to style your modules published in the top and bottom positions.

Option Description
Width Set the width of the grid column that contains the module in percent or choose Expand to fill up the available space evenly.
Max Width Set the module's maximum width.
Max Width Alignment Define the module's alignment if the grid column is larger than its max-width.

Grid options

List Options

Use these settings to style your list modules published in sidebar, mobile, top or bottom positions.

Joomla offers the following list modules: Articles - Archived, Articles - Categories, Articles - Latest, Articles - Most Read, Tags - Popular, Tags - Similar.

Option Description
List Style Select whether the list items should be separated with dividers or not.
Link Style Use the default link color or the muted color.

List options

Use these settings to style your menu modules.

Option Description
Menu Style Select whether the menu should be rendered as a horizontal subnav, a sidebar nav, or iconnav. The Default style depends on the position the module is published.
Menu Dividers Show dividers between menu items.

Menu options

Module Visibility

In Joomla, you can assign modules to specific pages. For more advanced options, we recommend installing a free extension from Regular Labs called Advanced Module Manager. It changes your Menu Assignments tab in the module settings to Assignments and provides more advanced settings to show modules on specific pages. The extension needs to be installed and activated in the Joomla extension manager.


Builder Module

Use the builder module to create sophisticated layouts with the YOOtheme Pro page builder above and below the main content. The builder module is a regular Joomla module. Publish it only in the top or bottom module position. Otherwise, it will not be rendered, and an error message will appear. This is because the page builder is designed to create layouts that can take up the full width of the viewport which is not possible for positions like the sidebar.

Note The layout settings in Layout → Top and Layout → Bottom are ignored by the builder module because it allows you to create multiple sections which each has its own settings.

Builder module

Open the Modules panel in the YOOtheme Pro customizer and click the Builder button to open the YOOtheme Pro page builder.

Open builder module

Editing the builder module in the Joomla module manager, click the Open Builder button to access the Modules panel.

Open builder module in Joomla

Advanced Layouts

The YOOtheme builder module is especially powerful in combination with the module and position elements from the YOOtheme Pro element library. Both elements collapse if they have no content output, and the layout adapts accordingly. This gives you a lot of possibilities to create advanced layouts above and below the main content. Read more in the collapsing layouts documentation.

YOOtheme Pro Documentation