Say that you’re a global company and have a bunch of universal global policies documented in Confluence. Those policies are then implemented specifically per country - those regional specifics should be documented too.
Or... you are a company with multiple products; you have a universal design language documented in Confluence, but you know that your individual products require specific guidelines and usage rules.
Both use cases require centrally managed content but also require specific contextual additions to made by the respective team.
You can do that by duplicating your universal content and/or leaving users to create their own specific docs. Duplicating content is usually a bad idea… as is sending readers on a journey across multiple spaces and pages just to get the information they need. So what do you do?
Simply create a page that has both EDITABLE and NON-EDITABLE content - nicely arranged, side by side.
Tools that you need:
Include page macro
Layouts
So, once you have your universal content space ready, do the following. For this example, we’re working with a page called Styles Sample Page in Space A.
Steps:
Create a new space (a team space) and a new page.
Use Layouts to split the page into two columns.
In the left* column, use Include page macro and point it to the Styles Sample Page in Space A.
*Or the right column if you’re using a right-to-left language.
Name the page and publish it.
What you get is a page where anything on the left-hand side is centrally managed and not editable, while teams can add notes, annotations, implementation instructions, and manage their own docs next to the relevant sections of the universal document.
Notes and tips:
Use Excerpt + Insert excerpt macros for higher granularity.
Yes, users can still delete the insert/include macro, but that can be easily restored if deleted by mistake.
Individual teams can still add new content on both the page and the space level.
This solution offers way more options and flexibility compared to comments.
Explore permissions and restrictions. Of course, teams must have read access to the universal content page. But you can restrict access to team spaces to team members only.
Use page templates and the copy page (with children) feature to speed up creation of team spaces.
Acknowledgement:
Thanks to @Anjana V K for presenting me with an interesting challenge and inspiring this post.
Kristian Klima
Director of Technical Content, Emplifi
Emplifi
Prague, Czechia
256 accepted answers
Online forums and learning are now in one easy-to-use experience.
By continuing, you accept the updated Community Terms of Use and acknowledge the Privacy Policy. Your public name, photo, and achievements may be publicly visible and available in search engines.
2 comments