Web Development Documentation

Adding a Custom Module

The procedure explains how to add a Custom HTML module in Joomla! 3.x using the Administrator interface. A Custom HTML module is a block of formatted text that can be configured to appear when one or more menu items are accessed.


A custom module allows you to add custom text and/or an image and place it in a position on the website.

Create a new Module

  1. In the Joomla! back-end (Control Panel), navigate to Extensions > Modules, then click the New Button to create a new module
    Creating a new Custom Module
  2. For "Select a Module Type," select Custom:
    Selecting "Custom" for the module type
  3. Enter the name of your module in the "Title *" field (see #1 below).
  4. (Optional) click "Hide" under "Show title" selection to the right if the module title should not be shown (see #2 below).
  5. For "Position," click the dropdown menu, and select the desired module position.  For example, to display the module to the right of the content area, select "Sidebar-b [sidebar-b]" (see #3 below).
  6. Under the formatting toolbars, enter the text that you would like to appear in the module.  You can format the text using the buttons on the editor toolbars (see #4 below).
  7. Click the "Menu Assignment" menu to specify which menu items will display your module (see #5 below).
  8. If the new module should appear on all pages, leave "On all pages" selected. If not, go to the next section, "Assigning the module to specific menu items."Configure Custom Module

Assigning the Module to specific menu items

If the module should appear only when one or more specific menu items are accessed, do the following:

  • On the "Menu Assignment" tab, click the dropdown box to the right of Module Assignment and select "Only on the pages selected" (see #1 below).
  • For Menu Selection, click "None" to the right of Select (see #2 below).
  • Click the check boxes for any menu items that should display the module when clicked (see #3 below).

Assigning module to menu items

Saving the Module

  • To save changes and continue editing the module, click the Save button to the upper left of the web page: Save button
  • When you are done editing the module, click "Save & Close" to the upper left to save your new module: Save & Close button

Joomla-Workshops-Button-Hugo