Splitting long articles into multiple, navigable pages in Joomla is made possible using the built-in Page Break feature.
If you've ever published a lengthy article in Joomla, you may have noticed that scrolling through a wall of text isn't always ideal for readers. Fortunately, Joomla includes a straightforward method for dividing content into a series of linked pages with table of contents and page navigation—achieved via page breaks.
Understanding Multipage Articles in Joomla
Joomla's native publishing system supports splitting any article into several linked pages by using its integrated page break feature. This isn't a workaround or a plugin—it's part of Joomla's core functionality. You can add as many page breaks as the database field size for articles allows, which means in practice there is no realistic limit for most use cases. This approach helps make long-form content more readable and manageable for your visitors.[Source]
When and Why to Use Multipage Articles
Multipage articles are particularly useful when dealing with in-depth guides, tutorials, or stories that could benefit from sectional navigation. They are often used for:
- Breaking up complex tutorials into logical steps
- Segmenting topics with distinct chapter-style divisions
- Improving reading comfort and page load times for image-heavy content
Visitors can navigate these articles easily using next/previous controls and the automatically generated table of contents.

Prerequisites
- Administrator access to your Joomla backend
- Permissions to edit or create articles
- Familiarity with the Joomla Article Editor (TinyMCE is the default editor, but other editors may also be configured)[Source]
Step-by-Step: Creating a Multipage Article with Page Breaks
The Page Break feature is central to Joomla’s article pagination. It inserts a special marker in your content, which the system interprets to split the article into separate pages.
1. Create or Edit an Article
Navigate to Content > Articles and either create a new article or open an existing one that you wish to split.
2. Position the Cursor and Insert a Page Break
In the article editor (with TinyMCE or your configured editor):
- Place your cursor at the point where you want the article to break into the next page (this could be before a major heading or section change).
- Open the CMS Content drop-down menu in the editor toolbar.
- Select Page Break.
A modal dialog will appear prompting you to fill out:
- Page Title: This is shown as the page heading after the main article title (e.g., "Page 2").
- Table of Contents Alias: This text is used in the table of contents navigation (e.g., "Chapter 2").
After entering your information, click Insert Page Break.[Source] [Source]
3. Repeat as Needed
You may insert multiple page breaks throughout your article. Each new break will create another page in the front-end display. The only constraint is the maximum article size allowed by your Joomla database, which exceeds typical article lengths.[Source]
4. Save and Preview the Article
Once all desired breaks are in place, save the article. Use Preview or view the article on your site to confirm the page navigation and the table of contents appear as expected.[Source]
Navigational Features Created by Page Breaks
Once page breaks have been inserted and the article is saved, visiting the article from the front-end displays:
- A page heading (showing the main title plus current page title)
- A table of contents with links to each section/page
- A "page indicator" showing which page is currently viewed
- "Previous" and "Next" navigation controls to step through the pages
- A link to view "All Pages" in a single view (useful for printing)[Source]
In the editor, page breaks appear as horizontal lines. On the site, these translate to the navigation and TOC controls described above.[Source]
Editing and Rearranging Page Breaks
While adding a page break is straightforward, modifying or moving them requires some care:
- You can select and delete a page break in the standard article editor.
- You cannot open an existing page break in its dialog to edit it. To change the titles or move the break, you must either delete the break and insert a new one, or use the Source Code editor.
- The Source Code editor (usually under
Tools > Source codein TinyMCE) shows the page break as an HTML<hr>tag with special attributes. Here, you can cut, paste, or edit the page break details directly.[Source]
Combining Page Breaks and Read More Breaks
Joomla allows blending Read More breaks (which show an article summary in a listing/blog) with Page Breaks within the same article. Typically, you might use a Read More break after the introduction so that only the first part appears on blog/category views, and page breaks to split subsequent sections for easier navigation. The pagination table of contents and navigation only appear once a user has clicked 'Read More' and is viewing the article's full display.[Source]
Display Options and Navigation Settings
Configuration options let you control the appearance of navigation links such as "Prev" and "Next". These options are available in the article options when displaying a full article view. You can choose where these navigation links are positioned (above or below the content), as well as enable or disable some elements as appropriate.[Source]
Practical Tips and Verifying Your Result
- After saving your changes, always preview the article from the front-end to confirm that headings, navigation, and the table of contents work as expected.
- Consider grouping related paragraphs under each page break for a logical reading experience.
- Use meaningful page titles and aliases for accessibility and clarity.
- If you make changes to existing page breaks, review them in the source code view for accuracy.
Technical Note: How Joomla Implements Page Breaks
A page break is a special <hr> HTML tag with certain attributes that Joomla recognises and uses for pagination. These HR tags are only seen in the editor or source view and are unaffected by front-end templates.[Source]
Conclusion
Splitting long content with page breaks is a core capability in Joomla, designed to improve the experience for both editors and readers. By following the steps above, you can efficiently break your articles into multiple pages with comprehensive navigation and a table of contents, without the need for extra plugins.
Add comment