Managing Document Page Breaks

Published on February 10, 2026 DRTE

Overview

By default, document sections render immediately after one another. To prevent a section from being split across two pages, or to start a new chapter on a fresh page, apply a specific CSS class to the HTML source of that section.

Example

Example document where the Order Summary section starts mid-page (1 of 2)

Order Summary section moved to the start of the next page (2 of 2)

Instructions

1. Locate the Target Section

Navigate to your Doc Template record. Under the Related tab, find the Button Sections/Doc Sections list and click the Section Number you wish to move to a new page.

Doc Sections list on the Doc Template record

2. Access the HTML Source Editor

Once the specific Section record is open:

1. Locate the header action buttons.
2. Click Update HTML Content Source.

Update HTML Content Source action on the Section record

3. Apply the Page Break Class

In the pop-up window, you will see the HTML string. Identify the first container tag (usually <p> or <div>) and insert the page-break class attribute.

Standard code: <p><strong>Order Summary</strong></p>

Original HTML source before the change

Modified code: <p class="page-break-before-always"><strong>Order Summary</strong></p>

HTML source with the page-break-before-always class added

4. Save and Validate

1. Click Next to confirm the change.
2. Click Preview Document in the top menu.
3. Verify that the content now begins on a new page in the PDF viewer.

Preview Document showing the section starting on a new page

Best Practices

1. Avoid redundancy: Only apply this class to the first element of a section.
2. Table consistency: If a section contains a large table, applying this class ensures the table header starts at the top of the page, improving readability.

Knowledge Article Number: KA-00099