In the Target configuration tab, you can find the settings that let you define the context of the Confluence pages that will be created by your recipe.

Page context

This section lets you configure where your Confluence pages will be created.
These options restrict the target space and parent page that will be available to a user triggering the recipe from the Jira issue view.


Confluence instance

This subsection indicates the URL of your local Confluence instance, where the pages will be published.

Space

Use this setting to restrict the Confluence space where the pages can be created. This space, and this space only, will be available as a target when the recipe is triggered.

Parent page

Use this setting to select the parent of the pages that will be published by your recipe.

The space and parent page options are mandatory. If you do not configure these options in the recipe, it will not be possible to use it, either manually or with a post-function.

Want more? Learn how to use dynamic parent pages to create nested pages.

If the page already exists

Use this option to select what to do when a page with a same title and under the same parent page already exists when your recipe is triggered.

Three possible behaviors are available:

  • Don't publish a new page
  • Overwrite the existing page
  • Append to the existing page

Don't publish a new page

This is the default behavior. If a page already exists with the same name and in the same location your recipe is supposed to create a page, nothing will happen, the recipe will not create a new page.

Overwrite the existing page

Use this option to write over a page created beforehand by the recipe. 

When this option is enabled, each time the recipe is run it will check if a page already exists in the same space and with the same parent page and the same page title. If this page exists and if it was created by the same recipe from the same source issue, the whole content of the Confluence page will be overwritten. 

Append to the existing page

Use this option to publish the content defined in your recipe at the bottom of the existing page.

This option can be used with any page in your Confluence instance, including pages not initially created by Elements Publish, as long as the user triggering the recipe has the permission to edit the page in Confluence.

You can learn more about this option in our dedicated tutorial.

Page author

This section lets you configure which Atlassian Cloud user will be the creator of the Confluence pages published by the add-on.

Publish on behalf of

Use this setting to select a user from your instance that will be used to create all the pages published by this recipe.

By default, pages are created by the user who triggers the recipe (either manually or through a post-function). This means that if this user has no permission to publish to Confluence or to access a given space or parent page in Confluence, they will not be able to create a page. By selecting a user with the appropriate permissions with this option, you can make sure that the recipe can always be successfully executed.

Monitoring

This section lets you configure how the created page can be monitored by the user who triggers the recipe.

Create link in source issue

Use this setting to create a link between the source issue and the Confluence page.
This link will appear in both the Jira issue and the Confluence page, as would any regular link created between an issue and a page.

Related tutorials