Jira Rules

AutoPage - Jira Rule Configuration

AutoPage streamlines documentation by keeping Jira and Confluence in sync. This guide walks you through configuring AutoPage rules within Jira.

The rule defines:

Which template is used for which Jira issue(s)
Under which parent page the generated Confluence pages are created

Creating Rules

Click “Create new rule” in the upper right corner.
You can always see on the label in the upper right if you are creating or editing a rule.

Rule Parameters

Parameter	Description
Rule Name	Name of the rule.
Rule Status	If active, the rule is evaluated. If inactive, it’s not applied.
Trigger	Defines when the rule runs: `Issue Events`, `Jira Post Function`, or `Sprint Events`.
Issue Event Types	Choose which issue events should trigger the rule. Select `All Events` to listen to all. (Visible only for `Issue Events` trigger)
Sprint Event Types	Choose which sprint events should trigger the rule. (Visible only for `Sprint Events` trigger)
Board	Select a Jira Board for which the sprint rule should apply. (Visible only for `Sprint Events` trigger)
Use explicit executing user	Enables specifying a fixed user to create/update pages. That user must have permission in Confluence.
Executing user	Jira user on whose behalf rules run. Must be an admin in both Jira and Confluence. (Visible when using explicit user or `Sprint Events`)
JQL Filter	JQL to filter which issues apply. Only evaluated when using `Issue Events` trigger.
Confluence Space Key	Space in which pages are created.
Confluence Template Page	Template page used for the content.
Confluence Page Title	Title of the generated pages. Supports placeholders like `$#Key` and `$#{sprint_id}` for uniqueness.
Confluence Page Labels	Optional. Can also use placeholders for dynamic labels.
Parent Page	Defines how to choose the parent page. Options: fixed page, another rule’s page, or a custom field.
Create Remote Issue Link	Creates a link to the generated page in the Jira issue’s “Issue Links” panel.
Issue Link Name	Name of the link type in the Jira panel (e.g., “Quest Description”).

Example of a rule in edit mode

Delete a rule

In the rule overview, you can delete the rule by clicking on the Delete icon in the upper right.

Parent Page Strategies

There are several strategies to determine the parent page in Confluence:

Fixed Page: Choose a specific Confluence page.
From another Rule: Use the page generated by a different rule.
Parent Issue Page: Use the page generated for a parent issue (e.g., Epic or main task).
From Custom Field: Dynamically choose the parent page using a custom Confluence Page Search field.