Templates Overview
An AutoPage Template is a Confluence page that an AutoPage rule copies when it creates a page for a Jira work item. The template contains AutoPage macros. On the new page, these macros show the content of the work item.
AutoPage knows which pages are templates. Templates have a status, you find them in one list, and the rule dialog suggests only templates.
When is a page a template?
Section titled “When is a page a template?”A page is an AutoPage Template in one of two cases:
- Detected: The page contains at least one AutoPage macro and is not linked to a Jira work item. AutoPage detects this when the page is published.
- Set manually: Someone marked the page as a template, for example by creating it in the Templates tab or with the Confluence menu entry AutoPage Template Management.
Some pages can never be templates:
- A page that an AutoPage rule created and linked to a work item. The link always wins: if such a page carries a template status, AutoPage removes it.
- Blog posts. Only pages can be templates.
Template status
Section titled “Template status”| Status | Meaning |
|---|---|
| Active | The page is a template. The rule dialog suggests it. The source shows how it became a template: detected or set manually. |
| Archived | The page is no longer a template. The rule dialog does not suggest it. Rules that already use it keep working. |
You change the status with Archive and Set active, in the Templates tab of the AutoPage admin page or in Confluence. Status changes can take about a minute to appear in lists and searches.
Who can do what
Section titled “Who can do what”| Task | Where | Who |
|---|---|---|
| List, create and scan templates | Templates tab of the AutoPage admin page in Jira | Jira administrators |
| Archive a template or set it active in the tab | Templates tab of the AutoPage admin page in Jira | Jira administrators with edit permission on the page in Confluence |
| Mark a page as template, archive it or set it active | Confluence: page menu ••• → Apps → AutoPage Template Management | Users with edit permission on the page |
| See the template status of a page | Confluence: AutoPage Template in the page byline | All users who can view the page |
| Choose a template for a rule | Rule dialog, action Create Confluence page | Users who can create rules (see Permissions) |
Next steps
Section titled “Next steps” Create a template Start from a blank page or a blueprint, or mark an existing page.
Manage templates Find, archive and reactivate templates, and scan the templates of your rules.
Use a template in a rule Choose the template that a rule copies.
Macros in templates The AutoPage macros and the Jira fields they support.