Excerpt and Include Excerpt macros in Confluence

[@dodraugen2k]

Thanks for this. Getting this to work with Excerpt/Include Excerpt, but _not_ with Table Excerpt and Table Excerpt Include. For some reason no named table excerpts are found when I try to use Table Excerpt Include. Any tips for troubleshooting? I could add my tables to Excerpt too, instead of Table Excerpt, but then they are not treated as tables for e.g. the Table Transformer macro on the page where I import them)

[@Donnerbalken_]

Is there a way to enable live-refresh? Or do I always need to manually reload the page whenever I change the parent page?

[@jimiwikmanofficial]

It should always refresh when you enter the page. Live-refresh could probably be added, but it is not added at the moment. It is a good suggestion though and perhaps a notification if the page is in edit mode as well, so the users know it is being worked on...

[@Donnerbalken_]

@@jimiwikmanofficial thank you for the fast answer. What my problem is, is that the page is often cached. And by just clicking on another page it does not reload the content if the source page was changed meanwhile. To always be certainly up to date I hence have to refresh the whole browser tab.

[@jimiwikmanofficial]

@@Donnerbalken_ The Macro should not be cached, though, as it should fetch the actual content through the connection. If the page caches the macro content as well, then that would be a bug. It is an interesting find and I will try to test it and see if I can verify it. Is it on Cloud or Data Center you see this behaviour?

[@Donnerbalken_]

@@jimiwikmanofficial it is on cloud. For me it will often not update when I navigate between previously opened confluence pages. However, whenever I fully refresh the tab manually, it will work. Thank you for your time and help :)

[@jimiwikmanofficial]

@@Donnerbalken_ Happy to help, and it is an interesting find indeed and some potential for improvement for Atlassian! Thank you for sharing.

[@MariaSchüller]

Thank you so much for the informative video! I am trying to create training record forms in Confluence for employees to fill in without them being able to edit the content of the actual form. I hope this will help me :)

[@jimiwikmanofficial]

Let me know how that goes and if we can help with anything.

[@dankini246]

Thanks for the video. The flow requires that you create your source content as excerpts in the first place. Is there any way to retrospectively turn content into excerpts? Basically i would like to: Go to source page > highlight content block > set to an excerpt for reuse elsewhere

[@jimiwikmanofficial]

I hear you :) Unfortunately, it can't be done at the moment. We can create a request for it and this could actually be used in many other ways as well, like marking a text and making that into a status or a Confluence task. That would be very nice.

[@dankini246]

@@jimiwikmanofficial thanks for the reply. It would very useful, and such an obvious usecase. Especially when often times someone else is the source page owner. How is such a request created?

[@encol7953]

nice video thanks. Is it possible to include an excerpt from a specific version of a source page or is it limited to including the excerpt content from the current source page only? Are you able to explain how excerpt differs from shared block? Thank you!

[@jimiwikmanofficial]

Sorry for late reply, I have been dealing with my health the last few weeks. Now, having an excerpt targeting a certain version can be done by setting different names on the Excerpt in the published version and any draft or previously published version. It might be a bit of a hassle, but it is possible. Shared Block, that would be the app Include Content you are referring to? marketplace.atlassian.com/apps/1217141/include-content?tab=overview&hosting=server

[@AmitSingh-kv1tw]

Which verion supports selection between different excerpt on same page.

[@jimiwikmanofficial]

Good question. I am not sure which version that came in, actually. It was announced all the way back in 2021 (community.atlassian.com/t5/Confluence-articles/Insert-multiple-excerpts-from-the-same-page/ba-p/1847318), so it was probably in late 7.1 versions on early 8 versions. confluence.atlassian.com/doc/confluence-release-notes-327.html

[@BramDemuynck-d7k]

Is there a way to know where (on which pages) an excerpt is included in?

[@jimiwikmanofficial]

At the moment, I don't think there is. It is a good suggestion though, and it could be added to the Confluence statistics I think.

[@captteemo9133]

The video was so weirdly buggy and the audio had so many cutoffs, you should use another recording software that does not capture just 5fps video and syncs it properly and disable noise cancellation or whatever effects you used to "improve" your audio.

[@jimiwikmanofficial]

Appreciate the comments, but not everyone have a studio to work from, and I am still learning the software since I have recently changed to both a new computer and new software. It is also quite an old video that I have re-uploaded on this channel. I'll do my best to improve the quality in the future.

[@captteemo9133]

​@@jimiwikmanofficial Thanks :). I do not meant studio grade quality. No video and sound with some reverb or little background noise would have been less distracting

[@jamesfoo8999]

No offence but this should be a 2 min video. Way too much fluff to listen to. I just want to know the basic functions, what to click to set excerpt and what to click to reuse it.

[@jimiwikmanofficial]

None taken. Everyone have different taste.

[@captteemo9133]

You could have e.g. prepared the demo texts, why should I watch how you create demo content, this is just badly prepared. ​@@jimiwikmanofficial

[@jeremyquadri]

couldn't this be sumarised in 2 min vid

[@jimiwikmanofficial]

It could, but this video is not a summary, but a tutorial :)