Create or Update a Confluence Page Action

This page is about Easy Integrations for Jira Cloud. Using Jira On-Prem? Click the On-Prem button above.

The Create or Update a Confluence Page action allows you to create or update Confluence pages with Jira or other action data. It is a powerful tool for enhancing collaboration and information sharing between your teams. This documentation provides details on how to configure the Create or Update a Confluence Page action.

🎯 Index

Prerequisites

Before using this action, ensure the following prerequisites are met:

Only Jira administrators have the necessary permissions to access and configure the Create or Update a Confluence Page action within Easy Integration.
Confluence Integration must be enabled for your Jira instance.

Options of action

Field Name

Description

Action name

Give a name for the action, it's just a reminder for you!

Condition

Enable or Disable condition.

When enabled, write the JavaScript condition of the listener. When enabled, Listener actions will work if the script returns true.

See Context variables, Scripts and Events for details. Example:

^{return startsWith(data.event.issue.fields.summary, 'Sultans of Swing');}

Space

Select the Confluence Space that the content is being created in.

Parent page

The parent content of the new content. If you are creating a top-level page, this can be left blank.

Template space

Choose space for space templates or leave blank for global templates.

Template

Choose a user defined global or space template

Action parameters (variables)

Write the JavaScript to return objects of variables. In the following example parameters variable is a JavaScript object and has 4 attributes.: "issue key", "issue summary", "issue status". "project name". These 4 variables can be used in the page title and page body.

^{var parameters = {};}
^{parameters['issue key'] = data.event.issue.key;}
^{parameters['issue summary'] = data.event.issue.fields.summary;}
^{parameters['issue status'] = data.event.issue.fields.status.name;}
^{parameters['project name'] = data.event.issue.fields.customfield_10500.name;}
^{return parameters;}

Page title

Title of the page.

You can use parameters in the title with double curly braces. Example: "New issue is created with key {{issueKey}}."

Update existing

Update if a page with the same title is found on the directory. Page names have to be unique within a space and if you will not check this option, this action may fail. When checked, additional option is required:

Field	Description
Append template	If checked, action appends the template body to the end of the current page, otherwise overrides the content.

Add page link to issue

If enabled, the page link will be added to issue. When this field is enabled, additional fields are required:

Field	Description
Issue ID or Key script	Write a JavaScript script which returns an Issue ID or key. Event data or previous actions data can be used in the script.
Confluence application link ID	Application links information can not be accessed by the apps. Please login to Jira, navigate to https://ttunca.atlassian.net/rest/applinks/latest/applicationlink, and copy the "id" value of the Confluence object. Example: 7d4bz3tu-fy2m-26p1-1g3m-3857972z9252

Example Screen

The following example creates an Azure DevOps ticket with the newly created Jira Bug data.

Template Example

Templates are used to create/update Confluence pages. All action parameters are available as variables.

Space templates are under the "Look and Feel" space settings.