Add multiexcerpt API: getMultiexcerptByPageID(pageID,multiexcerptname)


We have a use-case to use Confluence as the place for software documentation but want to use multiexcerpts outside of Confluence.

Add an API call like getMultiexcerptByPageID(pageID,multiexcerptname)

Freshdesk Tickets


Create a Support Ticket


Ture Hoefner
January 14, 2020, 4:19 PM

: in talking to our lead developer I was made aware of an existing REST API that may help you. This API gets the body of a macro, given the ID of the macro:

Then this macro could be used to convert the body from storage format to view (HTML):{to}-convert

When we evaluate this feature request for possible implementations in the plugin/app we will consider the case of getting a macro body for use inside of Confluence AND outside of Confluence.

Ture Hoefner
January 13, 2020, 3:59 PM

: It is possible that you are using the "new" JIRA view. Atlassian has an open bug to support JIRA voting in the new issue view:

To work around that you can temporarily turn off the new view: Personal Settings --> Jira Labs, toggle off the new issue view.

Andre Pliewischkies
January 13, 2020, 2:04 PM

How do I set my vote? I don’t see a button for that…

Ture Hoefner
January 10, 2020, 10:22 PM

Thank you for the detail . I will contact our leaders to bring this one to their attention. If you could, please add your vote to this issue. It will help it float towards the top of backlog lists that are sorted by priority.


Andre Pliewischkies
January 10, 2020, 12:00 PM

Hi Ture,

thanks for your suggestion. Actually my python scripts already perform all steps up to the last step “extracting the rich text body of the designated multiexcerpt”. This is quite complicated as it means to handle multiple nested macros with their own MultiExcerptNames and to find the correct closing-tag. And what about restrictions and user context? The efforts we faced are those you are judging now and every innovative customer will face them too. Provide this as a built-in function and our external scripts will be much easier to maintain. Do not burden your innovative plugin customers with that development and maintenance work.

Be innovative and use this change to enlarge your plugin scope to the world outside Confluence. Please see: the true potential of reusing text- and content snippets everywhere (inside and outside Confluence) leads to platform independency and to the fact, that customers will document really anything in Confluence and your plugin might evolve to a standard plugin for documentation and become relevant for really every customer group you can think of. We represent researchers, database architects and simple administrative staff. Rules, eLearnings, trainings, user documentation and regulations can melt like symbiosis.

- In the meantime we stumbled above another issue: The multiexcerpt can contain other excerpts originating from restricted pages bringing in the user context perspective. Here it is interesting where it leads to:

- the storage Format of that pageID only

- the storage Format of that page inluding the storage Format of the nested rich-text-Body (can be done recursively through our scripts)

- the render html of the macro body considering the user context (which is in the end what we like to have)

Suggestion: getMultiexcerptByPageID(pageID,multiexcerptname,<html or storage>)

Your pinned fields
Click on the next to a field label to start pinning.




Vlad PolonTech