Is there a macro that reports on excerpts and where they are being used?

Question

Currently, we are manually documenting the names of excerpts on our pages and where across our documentation those excerpts are being used.  That way, if it's ever an issue that the parent page is updated or the excerpt removed, we know exactly what other content might need to be updated to ensure those changes make sense.

Some recent content improvements are likely going to drastically increase the instances of excerpts being used across our content, which is going to make this manual tracking unwieldy at best.

It seems silly that there isn't a macro that can be inserted into a Confluence page that reports on excerpts in a certain Confluence space and tracks which other pages that excerpt is shared to.

Does this exist?  If yes, what is it called or how do I do it?

Laurie Sciutti · Answer

Hi @Susan Strayer ~ if I understand correctly, it sounds like something similar to what I do.  I have created a "Helpful Excerpt" page for each excerpt in use and I add an "excerpt" label to those pages for easy cataloging using the content by label macro.  What you can do is add the Incoming Links macro on those pages to see where each excerpt is used.

I'm not sure if this is the right way to go about it, but it definitely works well for me and provides a way to centrally locate all excerpts...

Susan Strayer · Answer

This is helpful but unfortunately doesn't give me what I need.  I essentially need to see a list of the pages that use excerpts, the names of the excerpts, and then a page tree for all the other pages that reference that excerpt using excerpt include.

Sayed's comment below also doesn't fulfill this since excerpt include only lets you reference the excerpts on a specific page, not insert a report of all of them for audit purposes.

Laurie Sciutti · Answer

Hi @Susan Strayer ~ have you tried "https://<your site>.atlassian.net/wiki/admin/pluginusage.action"?  This will essentially run this CQL which you can then further filter as needed:  dosearchsite.action?cql=macro+%3D+"excerpt"