The template is a simple Confluence page and you can use the full power of the Confluence page editor. The magic comes with the placeholder Macros for AutoPage. The template can be understood as a blueprint and you define where AutoPage should insert content of a Jira issue.

So let's start - Create a page

You can use whatever space and name you want for your template. It's a good idea to think about where to create your templates and how to name them. It's easier to find templates while configuring AutoPage rules and to make clear what's the usage of a page for users, if you have a naming and storage convention.

If a template should only be used in the context of a specific space, then create the template in this exact space. Should the template be used in different spaces, you better choose a more general space.

We recommend to use a name prefix as "AutoPage Template"  followed by the type of documentation (e.g. EPIC Documenation or Project Summary). 

Style your Page - Add macros to place Jira issue content

You can edit your template page as every other Confluence page. The only difference is that you can define how and what Jira issue content should be inserted with our great AutoPage-Macros.

To insert a macro just type / followed by Autopage or use the +-Icon in the editor menu:

AutoPage Macros 

There are three types of Macros to insert content, while creating a page from a template.

Supported Jira Field Types

Currently Supported Jira custom field types by the AutoPage Macros:

Field type	Macro type	Advanced Formatting
Paragraph (rich text, multi-line, issue description)	Rich Text (Block Macro)	Styling is inherited from Jira
Date / DateTime	Inline Macro	Formatting predefined
Text field / Short Text (single-line)	Inline Macro	Formatting can be defined
Number field	Inline Macro	Formatting predefined
User / User Picker (single user, multiple users)	Inline Macro	Formatting predefined
Project / Project Picker	Inline Macro	Formatting predefined
Issue status	Inline Macro	Formatting predefined
Issue priority	Inline Macro	Formatting predefined
Issue type	Inline Macro	Formatting predefined
Votes	Inline Macro	Formatting predefined
Labels	Inline Macro	Formatting predefined
Version / Version Picker	Inline Macro	Formatting predefined
Components	Inline Macro	Formatting predefined
Select List	Inline Macro	Formatting predefined
Radio Buttons	Inline Macro	Formatting predefined
Sprint	Inline Macro	Formatting predefined

  More Field types will be coming soon:

• Issuelinks & Parent
• Time tracking fields
• Service Desk fields

Macro Detail Setting

Once you have inserted a macro you got to configure the details. You can do so by clicking on the Macro Placeholder in the page edit mode and enter the configuration by click on the "pen icon":

The configuration menu appears on the right side where you can choose the Jira custom field you want to display

Macro Sync Mode

You can choose between to sync modes

1.  "Live Update" (Default setting)
   • The content of the configured Jira custom field is retrieved realtime when you load the confluence page. The user will see the latest Jira changes but with slower performance and no data displayed, when the communication with the Jira API does not deliver an answer.
2. "On Page Update"
   • This mode saves the Jira issue content into the confluence page when the Autopage rule is triggered. The user will see a snapshot of the Jira issue at a defined point in time. Loading performance is faster and content will be shown even if Jira is down.

Advanced Formatting Options

For Inline Macros with Text information you can define the display mode (see supported Jira Field Types).