Headers, footers and page numbers

A document title at the top, contact details at the bottom, or a “1 / 3” page label can all live in Header and Footer. Write the content once, and Tembuilder repeats it on the PDF sheets where that part is enabled.

Header and Footer sit under Global in Structure. Their content is shared, while each page can show or hide them—for example, a cover can omit both while the main content keeps them.

1. Add a Header or Footer

Expand Global in Structure, then select Add global element → Header or Footer. If it already exists, select it directly in the list to edit it.

The toggle beside each item controls its Global visibility. Turning it off hides that part across the document while keeping the content you wrote.

Adding a new Header or Footer is available in the base variant. Switch back to the base if you are editing another variant and do not see Add global element.

2. Edit the repeated content

Select Header or Footer to open its HTML, CSS, Props, and Config tabs.

With an existing template, start in Props to update a company name, website, or label used by that template. For example, the invoice template has a footerWebsite prop for the website shown at the bottom of the page.

Use HTML to change content or structure, and CSS to change its presentation. In Header/Footer HTML, {{ props.propName }} reads a prop belonging to that part; {{ global.props.propName }} reads a prop from Global.

3. Set Header and Footer margins

Open Header → Config → Margin or Footer → Config → Margin. Enable margins and enter the four sides in mm. The Background section below sets the background of that Header or Footer.

These margins are separate from Content margin. To align a header logo with a table in the body, set the Header’s Left/Right margins to match the content area’s Left/Right margins.

Header/Footer height follows its content, including its own margins. Content margin → Top/Bottom provides the gap between that area and the main content. To increase the gap after a Header, change Content margin Top; to inset a logo inside the Header, change the Header’s margins or CSS.

4. Hide it on a cover or a specific page

Select a page in Structure → Config → Layout, then turn off Header or Footer. For example, Cover can hide both while Invoice keeps them.

The shared content in Global stays intact. Turn the corresponding Layout setting back on to show it on this page again.

If a setting says off globally, enable the Header/Footer in Global first. A page cannot enable a part that is turned off globally.

To give a cover different settings from the main content, make it a separate page in Structure.

5. Insert automatic page numbers

Add this to Footer or Header HTML:

<span>{{ global.props.page_number }} / {{ global.props.total_pages }}</span>

These values are built into Global Props and filled by the system when the document is generated:

You do not need to create another prop to store page numbers. For a three-sheet document, this example displays 1 / 3, 2 / 3, and 3 / 3.

Numbers refer to PDF sheets, not the number of pages in Structure. One Structure page can produce several sheets, each with its own number. Hiding Header/Footer on a cover does not exclude that sheet from the total count.