The Confluence Gadget macro is a specific type of macro which is used to display gadgets, including JIRA gadgets, in a Confluence page. Once you have configured external gadgets in the Confluence Administration Console, they will appear in the Macro Browser.

17 Comments

The documentation around adding a Jira gadget to Confluence needs to be revised. I've tried to follow the above 3 times now- it makes no sense and seems to be incorrect.

What I *think* you need to do is to add your Jira gadget first to Confluence, then you can add it to your page. How you do that remains a mystery, as the link from the app help points back at this page.

well, that is documentation around sticking in a list of jira issues, which is pretty straightforward, works well and hasn't changed for a few years. What I'm trying to do is add a gadget to a page- which I get the impression is relatively straightforward, but so far I've been unsuccessful at. This particular part of the documentation just leads in a loop back to this page.

no- I've found that page. Perhaps if I explain the circle then it might make more sense. I use Jira studio.

I have some interesting data in a jira gadget, which I have on my dashboard. In my case it is a roadmap of upcoming releases. I'd like to use that on a wiki page, as some external members (read: clients) of my project team have problems understanding the difference between the wiki and jira, so they don't know where to find things. The road map is important for project management, so I'd like to have it in the wiki.

I start on this page

I go to the wiki, add a page, and follow the steps in [Inserting Gadgets into a Confluence Page or Blog Post. I see that all the gadgets listed there are different to my Jira gadgets, and were what was until recently called "macros" in Confluence.

I choose the jira portlet, and then try to add parameters that link to my jira gadget

I then click on documentation to try to work this out, which suggests for Jira 4 that I go to this page.

I'm guessing that what I'm trying to do isn't possible (it would be great if that wasn't the case!). If it isn't, can I suggest:

improve this page - it is a tad light on detail

calling something a "gadget" in jira and in confluence when they seem to be quite different things is confusing. Perhaps explain that on this page?

remove the jira portlet gadget for studio users, or at least explain that. I know there is an edge case where someone could be using jira 3x as well as studio, but...

Right, I see. It is possible to do what you want. The missing step seems to be that an administrator needs to manually add the JIRA gadgets to allow them to be used in the Confluence instance - they do not appear by default.

Also, note that macros are still called macros in Confluence. The gadget macro is a specific type of macro which is used to display a gadget in a Confluence page - so once you have configured external gadgets in the Confluence Administration Console, they will appear in the Macro Browser.

The JIRA Portlet macro is a legacy macro, which is not relevant to your use case, and will be removed altogether in a future release.

I am attempting to accomplish the same goal.. embedding JIRA gadgets in a confluence page. I have completed all of the instructions;

set up a trusted relationship with JIRA and confluence

subscribe to all of the gadgets

When I try to add the url to the Gadget feed I receive an error "invalid Gadget URL" I am copying the gadget URL from the link provided after I click on the "Gadget Subscriptions" in the JIRA "Add Gadget" list from my JIRA dash and it displays:

After migrating to version 5.4, Filter Results and Created versus Resolved gadgets stopped working.

I am getting errors like:

The selected filter filter-11157 has an error: A value with ID '10000' does not exist for the field 'project'.. or The selected filter filter-10210 has an error: Field 'issuetype' does not exist or this field cannot be viewed by anonymous users..

depending on th filter selected.

This was working OK before migrating (previous version was 5.2). At the same time we upgraded from JIRA 6.0 to JIRA 6.1

Hi Adolfo, your problems may be related to this issue.
CONF-31993
-
Filter results gadget (or anything that uses a filter in JIRA) isn't working.Resolved
. If you're experiencing something different, you should contact Support who will help you troubleshoot the problem.