How to use Jira issue collector with the HTML macro

This tutorial describes in detail how you can use the Jira issue collector with an HTML macro. This allows you to create Jira issues from your Confluence pages directly.

Instructions

To generate a Jira script:

Go to the relevant Jira project and select Project settings from the left sidebar.
Use Jira issue collector to create the required script.
1. Click Add issue collector.
2. Enter the Name, Issue type and Reporter for the collector. For this article, let’s create a feedback collector and create a bug for every feedback. So, select Bug as Issue type.
3. In the Trigger section, enter the Trigger text and the Trigger style for the collector. For our scenario, let’s keep the default options for both fields.
4. In the Issue collector section, specify the Template you require. For our scenario, let’s use the default options.
5. Click Submit.
6. Copy the script generated in the Embed in HTML tab.
Navigate to and open the relevant Confluence page. Add an HTML macro and edit the macro.
Select HTML embed code under Data source. Paste the generated script in the Embed code section.
Enter the required value in the Layout > Height of iframe (in px) parameter.
Make sure to specify the Height of rendered content parameter in the editor.
Save the changes and publish the page.

Note that it is recommended to provide the height for the collector in the HTML macro editor. Enter the minimum height (in px or em) in the Height of rendered content parameter of the macro.

Expected result

After publishing your page, the specified trigger text is shown. When the relevant action is performed, a Jira ticket is created based on the issue type specified for the collector. You can view this ticket under the Jira project for which the issue collector was created.

Continuing the scenario above, the result is as follows:

Once the page is published, a Provide feedback button is shown.
Click the button to open the feedback form as specified in the issue collector.
Provide the required details and click Submit.

As specified in the issue collector, a bug is created under the relevant Jira project.