Add Short Descriptions

Use the Excerpt Macro in Confluence to mark a portion of content on a page for reuse. This feature is best for marking short descriptions. The short description is a paragraph describing what a page is about and is meant to help users understand quickly if the content is helpful to them.

A short description in an Excerpt Macro can be placed anywhere on a page; often as the first paragraph. The Excerpt Macro can only be used once on each Confluence page. As the introduction to the concept, the excerpt is like the greeting at the beginning of the conversation; it sets the tone.

Find out how to add reusable content to the Excerpt Macro in Confluence.

Write Once, Use Everywhere

Ideally, every documentation page should have an excerpt. There are many uses for the short description in the excerpt, like including it on other pages in the documentation or providing it to search engines to help users find solutions. Some macros like the Children Display macro can even display the excerpt as preview text within the list of child pages. What a great way of previewing the content before you even open the page!

Next Up!
Organize Your Reusable Content

We Like Cookies

We’d like to set cookies to create a secure and effective browsing experience and to understand how you use our site.

Would you like to help us with that?

We use Google Analytics to understand how you interact with our site. For further details please read our privacy statement. If you don’t want to be tracked, click .