Reusing content is valuable for many different reasons. As a content author, you avoid duplicating content if the information is available elsewhere already. This saves time when writing and updating content and makes sure the content is consistent across the various locations it’s used in.
On this page you will learn how to build an inclusions library in Confluence and then re-use pieces of content from this library wherever needed in your Scroll site.
For general information and tips on content reuse, check out our Confluence Collaboration Hub article Content Reuse in Confluence with Includes and Create and use synced blocks.
Create an Inclusions Library in Confluence
Centralize all content that you plan to use multiple times across your site in one single inclusions library. The library can be a dedicated Confluence space or a parent page that you create. You can then re-use anything from an entire page, to a paragraph or a single image from that inclusions library in the actual published site.
Whenever you want to embed reusable content from the central location into your site, use one of these Confluence features:
-
Include Page — embeds an entire page's content inline.
-
Insert Excerpt — embeds a defined excerpt from a source page.
-
Synced Block — creates a reusable block that you can place on multiple pages; when you update the source block, all instances update automatically.
All three approaches are supported by Scroll Sites.
Some macros don't render correctly when placed inside a Synced Block or Excerpt — see Content Reuse and Macro Compatibility for the full compatibility list.
Building an inclusions library and reusing content can be done entirely with native Confluence functionality. Check out Confluence’s documentation on how to Use Confluence for technical documentation for all details.
If your inclusions library lives in a space that isn’t part of your Scroll site’s content sources, make sure to enable the Scroll site setting Display all included content as described on Allow to Display Content From Any Includes.
Keep the Inclusion Library from Being Published
Display content from include page and insert excerpt macros and synced blocks in your Scroll site even if the source pages are not part of your site’s content sources.
Unlike using Confluence permissions, the scroll-sites-no-publish label doesn’t keep your content from getting processed, uploaded and stored to Scroll Sites servers.
Want More Tips?
Check out the following articles from our Confluence Collaboration Hub: