The final override we will look at is the pagination override. This override can control the display of items-per-page and the pagination links used with lists of information, as shown in the following screenshot.

Typical Joomla! page showing a paginated list.

The rhuk_milkyway template provides a well-commented example for this override. The file is found here:


When the pagination list is required, Joomla! will look for this file in the default templates. If it is found, it will be loaded and the display functions it contains will be used.

There are four functions that can be used:


This function is responsible for showing the select list for the number of items to display per page.


This function is responsible for showing the list of page number links as well at the Start, End, Previous and Next links.


This function displays the links to other page numbers other than the “current” page.


This function displays the current page number, usually not hyperlinked.

Cheat Sheet

Using the rhuk_milkyway template as an example, here is a brief summary of the principles we’ve looked at.

Customise the Component Output

To override a component layout (for example the default layout in the article view), copy:




Read more about component output.

Customise the Module Output

To override a module layout (for example the Latest News module using the rhuk_milkyway template), copy:




Read more about module output.

Add New Module Styles

To add new module styles (chrome), add them to the following file:


Read more about module chrome.

Customise the Pagination Links

To customise the way the items-per-page selector and pagination links display, edit the following file: