Conceptual illustration for How to Create a Multipage Article in Joomla: Step-by-Step Preparation for 2026

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]

Note on Future-Year Guidance: This article is prepared based on Joomla documentation as of late 2026. Version specifics and new features introduced after this date are not covered unless explicitly stated in the referenced documentation.

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.

Conceptual illustration for How to Create a Multipage Article in Joomla: Step-by-Step Preparation for 2026 — supporting detail
Conceptual illustration: website requirements and content management.

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 code in 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.

Sources

Add comment

By submitting a comment, you agree to our Comment Policy and Privacy Policy. Please keep comments respectful, relevant, and free from spam or promotional content. Your name and comment may be displayed publicly, while your email address will not normally be published. Technical information, including your IP address, may be processed for moderation, security, and spam prevention.

Submit