Breadcrumbs

Scroll Placeholders

You can insert a range of placeholders into your templates to modify the export. Templates can be added within the Document Sections using the + icon in the editor toolbar or via the / or { keyboard shortcuts.  Placeholders reference metadata, and insert this metadata into content boxes.

If you need to reference content that isn't available from our current selection of template placeholders please check out how to

create custom template placeholders here

.


Default placeholders

The following placeholders are available to all PDF exporter users:

Name

Description

Settings

Chapter Heading

Displays the current chapter's heading (Heading 1).


Content Property

The specified content property on the root page.

You cannot set content properties manually by yourself – they are only set by third party add-ons.

  • Not available on Confluence Cloud.

Creation date

Displays the creation date of the current page.

Creator Username

Displays the username of the creator of the current page.

  • Only available in Content section for templates.

Creator Full Name

Displays the full name of the creator of the current page.

  • Only available in Content section for templates.

Current page number

Displays the number of the current page in this document.

  • Choose the page numbering format - numbers, letters or roman numerals

Document Creation Date

Displays the creation date of the exported root page.


Document Creator Username

Displays the username of the creator of the exported root page.


Document Creator Full Name

Displays the full name of the creator of the exported root page.


Document Last Modifier Username

Displays the username of the last modifier of the exported root page.


Document Last Modifier Full Name

Displays the full name of the last modifier of the exported root page.


Document Last Modification Date

Displays the last modification date of the exported root page.


Document Page ID

Displays the ID of the exported root page.


Document Page Count

Displays the total number of pages in this document.

Choose the page numbering format - numbers, letters or roman numerals


This placeholder is not compatible when using the segmentation mode on Confluence Server/Data Center.



Document Revision

Displays the revision of the exported root page.


Document Title

Displays the page title of the exported root page.


Document URL

Displays the document's Confluence URL.

  • Select between the full URL or a tiny URL, and display the link as the plain URL text, the page name, or custom text.

Export Date

Displays the date when the export was created.

Export User Username

Displays the username of the user who performed the export.


Export User Full Name

Displays the full name of the user who performed the export.


Include page

Insert the content of a certain page.

  • Specify the space key of the included page

  • Specify page title

  • Add a heading offset number, which is added to the rank of the heading on that page (e.g. if offset = 2, a heading 1 becomes a heading 3.)

Index

Displays an index with the index terms you defined for this export.

JSON Content Property

The specified JSON content property on the root page. This refers to properties available at:

<BASE_URL>/rest/api/content/<PAGE_ID>/property/<PROPERTY_KEY>

The placeholder returns the contents of the value field. For further information, please see the Atlassian docs for Cloud and Server/Datacenter.

(Optional) Specify a JSON Pointer to extract a specific field of a JSON structure. The path/JSON pointer of the content needs to be defined with a forward slash.

For example, if the value of a property is:

{
    "hello": "world",
    "foo": ["bar", "baz"]
}

Then you may use paths like these to extract the following values:

/helloworld

/foo/0 bar

Last Modification Date

The last modification date of the current page.

Last Modifier Username

Displays the username of the last modifier of the current page.

  • Only available in Content section for templates.

Last Modifier Full Name

Displays the full name of the last modifier of the current page.

  • Only available in Content section for templates.

Metadata

The specified Metadata value on the root page (Server / Data Center versions only)

  • Enable the Space Home Fallback option to use a page property on space home page if it is not defined on export root page

  • Within the Alternate text field you can enter specific text to show if the page property does not exist on the export root page or space home page

  • This placeholder requires an additional app,

    Comala Metadata for Confluence Server / Data Center

Page Content State

Displays the state of the current page or blogpost

  • Only available on Confluence Cloud

Page ID

Displays the ID of the current page

  • Only available in Content section for templates.

Page Revision

Displays the revision of the current page.

  • Only available in Content section for templates.

Page Property

Displays the specified

page property

on the root page.

Page Title

Displays the current page title.

  • Only available in Content section for templates.

PDF Author

Displays the value that is set in the PDF Author parameter within the  Export Properties


PDF Keywords

Displays the value that is set in the PDF Keywords parameter within the

Export Properties


PDF Subject

Displays the value that is set in the PDF Subject parameter within the

Export Properties


PDF Title

Displays the value that is set in the PDF Title parameter within the

Export Properties


Space Description

Displays the description of the space that contains the exported pages.


Space Key

Displays the Confluence space key for the exported pages.


Space logo

The logo of the exported space (or a fallback logo if none is defined).

  • Define the size

  • Select a fallback logo for if no space logo is defined

  • Choose if you want the logo to be rounded or square

Space Name

Displays the name of the Confluence space that the content belongs to.


Section Heading

Displays the current section's heading (Heading 2).


Table of Contents

Displays a table of contents for the document.

  • Control the depth of the TOC and define how many heading levels should be displayed. This number is shown on the placeholder.

Table of Codes

Displays a table of Code Blocks for the document

Table of Equations

Displays a table of Equations for the document

Table of Figures

Displays a table of figures for the document

Table of Tables

Displays a table of tables for the document

Template Title

Prints the name of the export template


Template Last Modification Date

Displays the last modification date of the export template used.

Scroll Document placeholders

If you are using Scroll Documents you can use the following placeholders in your template:


Please note that these placeholders are available when using Scroll Documents v3.6.0 (and newer)



Name

Description

Settings

Document ID (Scroll Documents)

Displays the ID of the exported document

  • Define an Alternate text as a fallback if the exported document ID is unavailable

Document Title (Scroll Documents)

Displays the title of the exported Scroll Document

  • Define an Alternate text as a fallback if the exported document title is unavailable

Variant Name (Scroll Documents)

Displays the name of the exported variant

  • Define an Alternate text as a fallback if the variant name is unavailable

  • The use of variants in Scroll Documents requires an extension app,

    Variants for Scroll Documents

Language (Scroll Documents)

Displays the language of the exported version

  • Define an Alternate text as a fallback if the variant name is unavailable

  • The use of translations in Scroll Documents requires an extension app,

    Translations for Scroll Documents

Version Name (Scroll Documents)

Displays the name of the exported version

  • Define an Alternate text as a fallback if the version name is unavailable

Version Saved Date (Scroll Documents)

Displays the ID of the exported version

Version Status (Scroll Documents)

Displays the status of the exported version

  • Define an Alternate text as a fallback if the version status is unavailable


Scroll Versions placeholders 

If you are using  Scroll Versions, you can use the following placeholders in your template:

Name

Description

Settings

Version ID (Scroll Versions)

Displays the ID of the exported version.


Version Name (Scroll Versions)

Displays the name of the exported version.


Version Description (Scroll Versions)

Displays the description of the exported version.


Version Release Date (Scroll Versions)

Displays the release date of the exported version.

Enter a custom string using the

allowed date formats

Variant ID (Scroll Versions)

Displays the ID of the exported variant.


Variant Name (Scroll Versions)

Displays the name of the exported variant.


Variant Description (Scroll Versions)

Displays the description of the exported variant.


Scroll Translations placeholders 

If you are using  Scroll Translations, you can use the following placeholders in your template:

Name

Description

Language Key (Scroll Translations)

Displays the language key of the exported language.

Language Name (Scroll Translations)

Displays the language name of the exported language.

Language Language (Scroll Translations)

Displays the language attribute of the exported language.

Language Country (Scroll Translations)

Displays the country of the exported language.

Language Variant (Scroll Translations)

This depends on the system and environment of the Confluence Server. Normally, it is empty.

Comala Document Management placeholders

If you have  integrated Comala Document Management with Scroll PDF Exporter, you can use the following placeholders in your template:

Name

Description

Workflow State Comment

The comment provided when transitioning the root page into another workflow state without an approval.

Workflow State Date

The date when the root page was transitioned into the current workflow state. The output format is customizable.

Workflow State Description

The description of the workflow state of the root page in the workflow definition.

Workflow State Content

The content revision that the current workflow state of the root page refers to.

Workflow State Username

The name of the user who transitioned the root page into its current workflow state.

Workflow State Name

The name of the workflow state of the root page.

Workflow State is Public

Indicates whether the current workflow state of the root page is in a public state.

Communardo Metadata placeholder

If you have installed Communardo Metadata for Confluence, you can use the following placeholder in your template:

Name

Description

Metadatafield

Renders a metadata field value defined via the Communardo Metadata for Confluence app