
How to Add a Cover Page to Confluence PDF Exports
Short answer: In Confluence's built-in export, a title page means a space admin writing HTML, and it only appears on space exports. With PDF Exporter for Confluence, a site admin opens Confluence Settings → PDF Exporter, edits a template, turns on Add cover page and picks one of nine designs or builds a custom one. Every export that uses the template starts with that cover.
A PDF that starts straight at the first line of page content looks unfinished when it goes to a client, a stakeholder or an auditor. In Confluence's built-in export, a title page is something a space admin writes in HTML, and it only applies to space exports, not single pages (more on that here).
PDF Exporter for Confluence makes the cover page a template setting. Pick one of nine ready-made designs, or lay out your own in a drag-and-drop designer. Every export that uses the template starts with that cover, whether it is one page or a whole page tree.
Prerequisites
Install PDF Exporter for Confluence from the Atlassian Marketplace. Cover pages are set in templates, and templates are managed by Confluence site admins.
Step 1: Open a Template
- Go to Confluence Settings (gear icon, top right)
- In the left sidebar, under Apps, select PDF Exporter
- Open an existing template to edit it, or click New Template
New to templates? How to Create Custom PDF Templates in Confluence covers the rest of the settings.
Step 2: Turn On the Cover Page
Open the Cover Page section and turn on Add cover page. A live preview of the cover updates as you change the settings below.
Step 3: Choose a Design
| Design | What it looks like |
|---|---|
| Classic | Centered layout with a horizontal rule |
| Corporate | Left-aligned with a solid accent bar |
| Modern | Large title beside an accent block |
| Executive | Thin accent line and refined typography |
| Bold | Dark accent banner with white text |
| Minimal | Title, subtitle and author only |
| Sidebar | Full-height accent stripe down the left edge |
| Split | Accent block across the top with the title, details below |
| Academic | Formal title page framed by double rules |
| Custom | Your own layout, built in the cover designer (Step 6) |
For client-facing documents, Corporate and Executive are safe choices. Academic suits formal reports and policies. Bold has a lot of visual weight, which works well for internal reports and launches.
Step 4: Set the Accent Color and Logo
Accent color: enter your brand's hex value. It colors the decorative elements of the ready-made designs: the bar in Corporate, the line in Executive, the stripe in Sidebar and so on. Very light colors can disappear against a white page, so check the preview.
Logo: upload a PNG, JPG or SVG. It is stored with the template, so it appears on every export that uses it. A horizontal logo with a transparent background usually fits the layouts best.
Background image: optionally add a full-page image behind the cover. It works with every design. Large images are reduced to a page-sized JPEG.
Step 5: Fill In Subtitle and Author with Variables
Subtitle and author are optional, and both accept variables. Type { in the field to pick one:
{title}: the page title{date}: the date{year}: the year{lastEditedBy}: the person who last edited the page
Examples:
- Subtitle:
Technical Specification · {date} - Subtitle:
Confidential · {year} - Author:
Prepared by {lastEditedBy}
Because the values fill in at export time, the cover stays current without anyone editing the template. For a fixed author, a team name such as "Solutions Engineering" ages better than a person's name.
Step 6 (Optional): Design a Custom Cover
Choose the Custom tile and the cover designer opens. To reopen it later, choose Custom again or the Edit design tile next to it.
Elements: Title, Subtitle, Author, Date, Text, Logo, Image and Line. Drag one onto the page, or click it to add it. The page is shown at your template's page size and orientation, with the background image behind it.
Placing elements:
- Drag to move. Use the handles on the left and right to change the width; text wraps inside the box.
- Edges snap to the page center and to other elements, with a guide line while snapped.
- Nudge the selected element with the arrow keys, holding Shift for bigger steps. Delete removes it.
- Set exact values (distance from left, distance from top, width) in the settings panel.
Styling: text elements have size, color, alignment and bold. Lines have color and thickness. The Text element accepts the same variables as the subtitle. The Custom design has no accent color; each element carries its own.
Images: add the Image element or drop an image file onto the page. You can use up to 4 images per cover, in PNG, JPEG, GIF or WebP, up to 5MB each. Images are shrunk in your browser before saving, so templates and exports stay light.
Undo and reset: Undo and Redo work with the usual shortcuts. Discard changes restores the layout the designer opened with, and Reset to default starts over.
Click Done to return to the template, then Save Changes.
The Title element prints each exported page's own title, and long titles wrap inside their box. Leave room below it, and check a page with a long title in the preview.
Step 7: Save and Test
Save the template. It is available to all users straight away.
To test it, open a page without child pages and click Export to PDF under the page title. The compact dialog shows a live preview of the actual PDF. Select your template from the dropdown and the preview re-renders with your cover. If the logo is too large or the subtitle reads oddly, adjust the template and check again.
How the Cover Fits into the PDF
The cover is always the first page. Headers, footers and page numbers are not printed on it, and page numbering starts from the first content page.
[Cover page]
[Table of contents] if enabled
[Content pages] page numbers start here
Exporting Without a Cover
For quick internal exports, keep a template without a cover page, such as the built-in Default or Minimal template. Users choose the right template from the dropdown at export time.


