> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pdfnoodle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Page Break

> The Page Break component ensures precise control over how your document flows during PDF generation. It automatically forces a page break (page-break-before: always), so you can decide exactly where a new page should begin. This is especially useful for separating sections like chapters, invoices, or grouped content in your document.

<img src="https://mintcdn.com/pdforge/rwoRLXXUvihWxlAY/images/components/image-1-21.png?fit=max&auto=format&n=rwoRLXXUvihWxlAY&q=85&s=38ca3ed6a753e2c0df2c2eca3b746a08" alt="" width="862" height="93" data-path="images/components/image-1-21.png" />

***

### How It Works

When included in your template, the Page Break component applies a CSS rule (*page-break-before: always*), ensuring that everything after it starts on a new page.

<Success>
  **Hint:** Use this component anytime you want to control the exact pagination
  of your generated PDF, rather than relying only on automatic page flow.
</Success>

### Conditional Rendering

You can control the visibility of the Page Break using the Conditional rendering option:

* Add a variable inside the Show if field.
* If the variable is present in your payload, the Page Break will appear.
* If the variable is absent, the Page Break won’t render.

#### Example:

<img src="https://mintcdn.com/pdforge/rwoRLXXUvihWxlAY/images/components/-example-2.png?fit=max&auto=format&n=rwoRLXXUvihWxlAY&q=85&s=db95c2b38b711329e240913dc159660d" alt="" width="298" height="90" data-path="images/components/-example-2.png" />

```
{
  "page_break_trigger": true
}
```

If you add `{{ page_break_trigger }}` to the “Show if” field, the page break will only apply when this variable exists.