Showing results for 
Search instead for 
Did you mean: 
Sign up Log in
Deleted user
0 / 0 points
badges earned

Your Points Tracker
  • Global
  • Feed

Badge for your thoughts?

You're enrolled in our new beta rewards program. Join our group to get the inside scoop and share your feedback.

Join group
Give the gift of kudos
You have 0 kudos available to give
Who do you want to recognize?
Why do you want to recognize them?
Great job appreciating your peers!
Check back soon to give more kudos.

Past Kudos Given
No kudos given
You haven't given any kudos yet. Share the love above and you'll see it here.

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Why can't I insert the multi-excerpt-include macro using Wiki markup?

I need to insert several multi-excerpt-include macros on pages in bulk, but I'm unable to use Wiki markup to do it as I was when I created the multi-excerpt macro entries. When I try, the Wiki Markup macro appears with the multi-excerpt-include macros enclosed inside, and nothing is rendered.

I tried manually inserting the macro, using the editor, and then checked the storage format, using the Source Editor, and it looks like the syntax for both the macro and the parameters has changed:

{multi-excerpt-include:pageTitle=ABC|name=DEF|nopanel=true} has become
{multiexcerpt-include:PageWithExcerpt=ABC|MultiExcerptName=DEF|nopanel=true} (or would become that, if the new syntax worked in Wiki Markup, which it doesn't).

When I use the new syntax, the Wiki Markup macro still appears with the macro code enclosed, and it renders an error on the page: "Unknown macro: {multiexcerpt-include}".

I tried changing the name of the macro back to the old version with the hypen (which doesn't generate an error) with different combination of parameter names, but the only results are either nothing or "Page does not exist." (I've double checked the page name and the excerpt name and they always work when I insert the macro manually.)

It's not practical to insert all of these macros individually using the Insert Macro function. Is there some undocumented way of converting this macro to Wiki Markup, and if I can't use Wiki Markup, is there another way to insert these in bulk?

We are using Confluence 5.1.2.

4 answers

1 accepted

0 votes
Answer accepted

Thanks for responding, Roy. I see you were just as frustrated as I was.

Our Confluence admin forwarded my question to Artemis support and Brendan got back to us a couple of weeks ago. He was very helpful and explained the situation, but he didn't make any promises. He just said he'd look into getting the storage format to work with Wiki markup, and that only two customers requested the two implementations interact. (I guess you're the other one.)

I don't know if I need the two formats to interact, but they need to at least allow us to use Wiki markup for both of them.

The issue is a bit trickier than people realize. Basically, the old Wiki parameters ("name" and "pageTitle" are still supported, but only if you use Wiki markup to enter and retrieve the excerpt, and the new XHTML parameter names, MultiExcerptName and PageWithExcerpt, are supported, but only if you use the Insert -- Other Macros function, via the Editor. (You can enter an XHTML Multiexcerpt macro in Wiki markup using MultiExcerptName, but not a Multiexcerpt-include macro, so you can't really use Wiki markup in Confluence 4 and 5 as the Artemis demo says. I thought this was misleading at best.)

I have to admit I wasn't fully aware of the problem, until it became important for me to use Wiki markup extensively, and I tested the macros thoroughly. At first when Wiki markup didn't work, I thought I must be doing something wrong. It didn't occur to me that anyone would implement something like this halfway. Maybe that's why more people haven't said anything about it. Let's hope those who don't have time to enter macros through the Editor, which is the only option for retrieving XHTML multiexcerpts now, step up and say they want this fixed.

I was dealing with a simliar problem. I posted a question on the Artemis support site since it is their plug-in and got a prompt response:

Basically, the issue is the old wiki markup and the new XHTML are both supported, but don't work with one another at this time. They imply they will fix this sometime in the future - I hope soon!

Good luck

This video documents a working solution. Here is the markup to use

In one document named doc1 insert the following markup


Now in another document include the excerpt


Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Confluence

🥓🙅🏻‍♀️ Meet-less May Badge!

Hello Confluence Community!  What if i told you that you could have a healthier life and be 100% meet-less? This month, we're promoting a healthy, balanced work diet with Confluence. (Read m...

568 views 4 24
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you