Publish Content

The Publish Content action allows you to publish Confluence content to different pages or spaces in your instance. This will create a copy of the content in the specified spaces and/or as a child of existing pages.

Currently this action only supports pages - we do not support the publishing of additional content types (folders, blogs, databases, whiteboards, etc.).

If publishing other content types is a requirement for you, please let us know via our Customer Support portal.

Configuration Section	Name of Field	Type of Field	Description
Publish content location	Select the page(s) to publish your page to	Page multi-select	Search for and select pages for your page to be published to.
Publish content location	Select the space(s) to publish your page to	Space multi-select	Search for and select spaces for your page to be published to. It will be published as a child of the space’s homepage.
Publish content settings	Page title	Text field	This field allows you to change the title of the original page when it is published. If Clone page’s parent hierarchy is enabled, the titles of ancestor pages will not be updated. This field supports variable substitution - for more information please see the documentation.
Publish content settings	Clone page’s parent hierarchy	Checkbox	Additionally publish the original page’s ancestors, maintaining the page hierarchy. This will copy all pages between the original page and its current space's homepage into the new publish locations.
Publish content settings	Add page data to published page	Data select	Copy attachments, permissions, and/or labels present on the original page but not the published page(s) when publishing.
Publish content settings	Publish page with transitioner as owner	Checkbox	Publish the page as the user who transitioned the workflow instead of the Workflows for Confluence app.
Publish content settings	Copy page content properties	Checkbox	Copy existing content properties from the original page when publishing, excluding the Workflows for Confluence generated content properties.
Publish content settings	Copy Workflows metadata from original page	Checkbox	Copy metadata regarding the workflow from the original page and display the data within Workflows for Confluence macros on the published page. The behaviour of macros on the published page is as follows: Workflows Metadata macros: Status: This macro displays the name of the Page Status, Approval Stage or Create Official Version step immediately preceding the Publish Content action on the workflow which is applied to the original page. If this step is an Approval Stage, a suffix is appended showing the number of approvers. Approvers List: This macro shows a list of all approvers who approved the original page, given that the step preceding the Publish Content action is an Approval Stage. Transition Date: This macro displays the timestamp at which the original page was transitioned through the Publish Content action. Unique Page ID: This macro shows the Confluence page ID of the original page. Workflows Approvers Metadata macros: All Approvers for Current Workflow: This macro will display all approvers that have been added on any Approval Stages on the original page, up until the page was published. Latest Approvals for Current Workflow: This macro will display all approvers who have made a decision (approved or rejected the page) on any Approval Stages on the original page, up until the page was published.

Behaviour

When a space is selected as a Publish content location, the action will clone the original page into the destination space immediately under that space's homepage. If Clone page’s parent hierarchy is checked, each parent page will also be cloned into the new space. The page order will be maintained and the upper-most page will be immediately under the new space's homepage.

When a page is selected as a Publish content location, the action will clone the original page immediately under the specified page as a child. With Clone page’s parent hierarchy checked, each parent page will also be cloned under the destination page. The page order will be maintained and the upper most page will be immediately below the target page.

When you publish a page, a link will be created between the original and published pages. This means that when your original page is again transitioned through the Publish Content action, the existing published page(s) will be updated to reflect the new content.

With Clone page’s parent hierarchy checked, any changes to the hierarchy in the original page tree will be reflected in the published page hierarchy when the Publish Content action is next triggered. This includes any changes to the published page hierarchy which takes the published page hierarchy out of alignment with the original page hierarchy.

With Clone page’s parent hierarchy unchecked, any published pages which have been moved away from their Publish content location will be returned to their correct location as a child of the Publish content location when the Publish Content action is next triggered.

If a page with the same title already exists in a space, and you have not set the Page title field, a number in brackets will be appended to the title name to make it unique (e.g. "Published Page" => "Published Page (2)").

When publishing a page containing links to the destination space, the links will be updated to redirect users to equivalent pages in the destination space. You can read more about this feature here.

Limitations

We do not support multiple Publish content locations which all publish to the same space due to limitations of Confluence.

If you have multiple Publish content locations which all publish to the same space within the same Publish Content action: multiple published pages will be created on the first publish, but they will be unable to be updated on subsequent Publish Content actions.
If you have multiple Publish content locations which all publish to the same space split across different Publish Content actions, a single published page will be created which will be moved to the Publish content location for the latest Publish Content action.

We do not support the publishing of non-page content types (folders, blogs, databases, whiteboards, etc.).

Need support? We’re here to help 🧡

If you have any questions or would like to speak with us about Workflows, please don’t hesitate to reach out to our Customer Support team.