Get the high-level details you need to set up your Confluence Cloud site in order to meet your team's needs.
Learn how to create great content and organize it.
Learn how to collaborate on pages and blogs, get notified about activity, and view analytics to see how content is performing.
Adjust settings around who can see what content on your site and what actions they can perform on it.
Find everything a site admin needs to know to keep their Confluence Cloud site running smoothly.
Get an overview of the macros and premium features that extend Confluence functionality.
The Excerpt macro is used to mark a part of a page's content for re-use. Defining an excerpt enables other macros, such as the Excerpt Include and Blog Posts macros, to display the marked content elsewhere.
You can add multiple excerpts per page and distinguish them from one another with a name you assign them. This allows you to create a page full of blocks of content to reuse on other pages. The content you add to the excerpt becomes the single source, which allows you to make a change in that one place, and all the pages that use the Excerpt Include macro to show that content will reflect the changes you made in the Excerpt macro.
Use the Excerpt macro
To add the Excerpt macro:
In the Confluence editor, select > View more
Find the Excerpt macro and select it. The macro placeholder is added and the right panel opens.
Enter a name for the macro so that you can reference it on another page using the Excerpt Include macro.
If you don't give the macro a name, you will only be able to include the content from the first Excerpt macro on this page.
Select the Hide Excerpted Content check box if you want the content inside the macro to be hidden when this page is published.
Add your content inside the Excerpt macro placeholder in the page. Most of the formatting options can be used, and elements in the toolbar can be inserted into the macro.
You can also type / into the page to bring up the same list you'd see by selecting from the toolbar.
To edit the Excerpt macro:
Select the macro placeholder. The floating toolbar appears.
Select Edit. The right panel opens.
Modify the parameters. Your changes are saved as you go.
Resume editing the page, and the panel closes.
Parameters are options that you can set to control the content or format of the macro output. Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the browser, it will be listed below in brackets (example).
Allows you to identify this macro so that you can add multiple Excerpt macros to one page and use a specific one on another page using the Excerpt Include macro.
Hide Excerpted Content
Controls whether the page content contained in the Excerpt macro placeholder is displayed on the page.
Note that this option affects only the page that contains the Excerpt macro. It does not affect any pages where the content is reused.
Wiki markup example
Wiki markup is only supported in the legacy editor.
Wiki markup is useful when you need to add a macro outside the editor, for example as custom content in the sidebar, header or footer of a space.
Macro name: excerpt
Macro body: Accepts rich text.
The following additional parameter is available in storage format and wiki markup. It performs the same function as the options panel in the editor.
Parameter description and accepted values
Determines whether the content of the Excerpt macro body is displayed on a new line or inline.
This option affects only the page that contains the Excerpt macro. It does not affect any pages where the content is reused.
Was this helpful?