This is the documentation for an older version of Scroll PDF Exporter. Here you can view the most up-to-date version of the Scroll PDF Exporter documentation.

Adding page breaks

You can either add page breaks in your CSS (for example after every heading 2) or to your Confluence pages. To add a page break to your Confluence pages, you need to use a macro. We recommend creating a user macro as described below.

This help document is about adding page breaks. If you want to remove problematic, unwanted page breaks between certain elements on your page, you can so using a custom macro.

Before you begin: Before you can create the macro, you must log in with Confluence Admin permissions.

To install the macro:

  1. Click the cog icon at top right of the screen and select Confluence Admin.
    The Administration Console is displayed.
  2. In the Configuration section, click User Macros.
    The screen User Macros is displayed.
  3. Click Create a User Macro.
  4. Enter 'page-break' in the field Macro Name.
  5. Activate the option Visible to all users in the Macro Browser.
  6. Enter 'Scroll Pagebreak' in the field Macro Title.
  7. Enter 'Inserts a page break in the exported PDF' in the field Description.
  8. Select Formatting in the Categories drop-down.
  9. Leave the field Icon URL empty.
  10. Enter the url of this page in the field Documentation URL.
  11. Activate the option No macro body.
  12. Replace the text in the field Template with the following:

    ## @noparams
    <ac:macro ac:name="scroll-pi"><ac:parameter ac:name="type">pagebreak</ac:parameter></ac:macro>
  13. Click Save.
    The macro is listed in the list Installed User Macros.

The user macro is created and can now be used to add page breaks to your Confluence pages.

To use the macro, enter {scroll-pagebreak} on the position you want to insert a pagebreak.