Organize Your Reusable Content header image
user-help

Organize Your Reusable Content

In Confluence, create a rich collection of reusable content. This is known as an Include Library, made up of one or more spaces containing reusable content items.

An Include Library is made up of one or more spaces containing reusable content items like text, images, diagrams, and so on. Each piece of content in the Include Library lives on an individual page, these pages are organized strategically for easy content identification. Think of the Include Library as one or more library shelves containing the content you reuse throughout your documentation.

Library Structure

Within an Include Library, the structure of the documentation is typically made up of two different types of pages. Both page types are essentially just Confluence pages, but with a unique combination of naming, organization, and page contents.

The two Include Library page types are:

Resource

A resource is a page containing a reusable piece of content.

resource.png
Resource with text for a user task

Collection

A collection is a page with one or more related resource pages or sub-collections as child pages.

collection.png
Collection of text related to user tasks

Page Organization

When organizing the structure of a space that’s part of your Include Library, the highest hierarchy level is typically made up of collections. These collections of technical documentation contain child resources or sub-collections.

include-library-hierarchy.png

You can also use Labels for additional organization and sorting within your Include Library.

Naming Convention

Using a simple and consistent naming scheme, the spaces and pages that make up the Include Library are easy to identify and organize. Find a naming scheme that makes sense to the whole team which can be used for any resource type and can be easily organized. Great naming schemes are often hierarchical and descriptive.

To help the team identify content in the Include Library and obscure it from users, the title of a space or page within your Include Library should begin with an underscore (_).

Learn how to  create an Include Library space in Confluence.

Templates

To help your team quickly add content to your Include Library space(s), create templates for resource and collection pages of your technical documentation.

Resource

Your resource page template should be relatively blank, since team members will add different types of content on this type of page. In your template, be sure to add:

  • A generic page title that acts as a template for your page naming scheme.

  • Instructional text that gives guidance or calls out standards for creating different types of resources.

resource-template.png

Collection

The collection page template will most likely not have any content added to it, and should act as an informational page displaying child resources and sub-collections. In your template, add:

  • A generic page title that acts as a template for your page naming scheme.

  • Create from Template macro with the button text "Add a Collection". Team members can click this button to add a child sub-collection using the collection page template.

  • Create from Template macro with the button text "Add a Resource". Team members can click this button to add a child resource using the resource page template.

collection-template.png

Learn more about  creating templates in Confluence.

Adding Content

As you create resource pages in your Include Library, keep in mind that the way content displays on the page is exactly the same way it will display on any page including that content. To ensure your content looks its best when reused:

  • Remove all line breaks, especially at the bottom of the page. The  Confluence Source Editor is a great app for this.

  • Be careful what heading level you use in the content, since it may be included on a page with existing headings.

If you feel like the content you're creating needs headings, consider breaking it up further into smaller pieces so it's more reusable.

  • Set image dimensions, alignment, and alt text

Embed comments

Read on..

Use the Excerpt Macro in Confluence to mark a portion of content on a page for reuse. This feature is best formarking 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.

user-help
Steffen Burzlaff Steffen Burzlaff

Once you’ve added content as Page Excerpts or within your Include Library, use macros to include that content in your documentation.

user-help
Steffen Burzlaff Steffen Burzlaff

If you use Scroll Versions for Confluence Server or Data Center, you can manage an include library with multiple versions and languages.

user-help
Steffen Burzlaff Steffen Burzlaff

Learn why planning matters, learn tips on how you plan and structure content effectively. This is the first step in our content lifecycle.

user-help
Steffen Burzlaff Steffen Burzlaff

Confluence databases are a fantastic tool at the fingertips of all Confluence users. And while you can do a lot with them, this video dives into the very best ways to use them. Explore the benefits of starting simple, linking instead of duplicating, and setting up your databases for simplification and effectiveness.

best-practice
Matt Reiner Matt Reiner

In this video, we dive into the best practices for collaborating within Confluence, covering everything from editing content with your team in real-time to getting effective feedback through comments and reactions.

tutorial
Steffen Burzlaff Steffen Burzlaff

This video covers the basics from selecting and using pre-made templates to creating and customizing your own. Learn why templates are important to maintain consistency and enhance productivity.

tutorial
Steffen Burzlaff Steffen Burzlaff

In this video, we dive into the essentials of creating and editing content in Confluence Cloud. By the end of this episode, you'll have the knowledge and confidence to create dynamic pages and blogs that effectively communicate your ideas and information.

tutorial
Steffen Burzlaff Steffen Burzlaff

Here we're going to help you get comfortable with the general interface and spaces within Confluence. By the end, you'll be able to navigate your Confluence site with confidence and understand how to create and manage spaces effectively.

tutorial
Steffen Burzlaff Steffen Burzlaff

We manage a lot of contacts on the day-to-day, and Confluence databases is a really great way to do this collaboratively. No, it won't replace a full CRM system like Salesforce or Hubspot, but if your working with a few hundred records, it's super powerful to have them right in Confluence where your team is collaborating.

use-case
Steffen Burzlaff Steffen Burzlaff

Maybe your team collaborates on all types of content together, and Confluence is a great place for this. When it comes to managing all that content creation, and helping the team understand where each piece is in the process, Confluence databases are here to help.

use-case
Steffen Burzlaff Steffen Burzlaff

We'll dive into the benefits of using Confluence and give you details on how the structure of Confluence works. We'll then walk you through the process of setting up your Confluence account, from signing up to the first view of the interface.

tutorial
Steffen Burzlaff Steffen Burzlaff

Whether you're new to Confluence Cloud or looking to refine your skills, this video is designed to clarify what page management truly entails and why it's crucial for maintaining an effective knowledge base.

best-practice
Steffen Burzlaff Steffen Burzlaff

Let's say your team wants to start a really new and fun project. Like, to make a really cool swag store for your organization. Great project idea, but how can you take this pie in the sky idea from planning all the way to done? Well, that's where Confluence whiteboards come in. Confluence whiteboards are the place where your team can quickly throw in their ideas, organize those ideas, visualize the ideas for clarity and planning, and then move them to tools like Jira and Trello or even elsewhere in Confluence to get working. In this video, we will look at the best ways to use Confluence whiteboards to make your team's idea a reality.

best-practice
Steffen Burzlaff Steffen Burzlaff

Illustration of website page and chart. Through project management, you distribute resources and tasks, and clearly define who's accountable for what. Learn how Confluence Cloud can be your go-to for managing projects.

use-case
Steffen Burzlaff Steffen Burzlaff

Creating and managing content in Confluence Cloud can sometimes feel like navigating a maze. You're managing multiple tasks, trying to ensure clarity in your documentation, and aiming for efficiency—all while keeping up with the ever-evolving demands of your users and your team.

best-practice
Steffen Burzlaff Steffen Burzlaff

Confluence Cloud is a perfect place to create great tables. To understand what you’re looking at, your team can use data visualization and charts to draw out valuable data insights.

best-practice
Steffen Burzlaff Steffen Burzlaff

If you're a seasoned Confluence Cloud user, you probably know the struggle of dealing with outdated content or encountering repetitive tasks like creating meeting notes over and over again. But you may have also heard whispers of a feature that could take your productivity to the next level: Automations for Confluence Cloud.

best-practice
Steffen Burzlaff Steffen Burzlaff

In this tutorial we give you and overview about the most important formatting options and show you where you can find them.

tutorial
Steffen Burzlaff Steffen Burzlaff

Beyond just having some tools and processes, the success of a project really depends on the how well your project team can collaborate and work towards a common goal.

use-case
Steffen Burzlaff Steffen Burzlaff

Your Confluence content can quickly grow out of control if you don't start with a sensible structure. Avoid a cataclysm by building the Confluence with your contributors at the forefront of your plans.

best-practice
Steffen Burzlaff Steffen Burzlaff

If a new team member doesn't create a Confluence page in their first 3 weeks, they likely won't ever create one. Onboarding them to Confluence is incredibly important and our guide will show you how.

best-practice
Steffen Burzlaff Steffen Burzlaff

If you've published your Confluence content online but aren't seeing users flow in from search engines, you'll need to do some search engine optimization. It is possible in Confluence and we'll show you how.

best-practice
Steffen Burzlaff Steffen Burzlaff

Once you build a great foundation for writing release notes in Confluence, you can stop treating them as a chore that needs to be dealt with and start using them as a valuable tool to connect with your users.

use-case
Steffen Burzlaff Steffen Burzlaff

Learning when to use restrictions and how to implement permissions are key tools to enabling your organization to make the most out of Confluence.

best-practice
Steffen Burzlaff Steffen Burzlaff

There is a secret page type you can build in Confluence that makes it so much easier to view hundreds of pages worth of information so much quicker and easier.

best-practice
Steffen Burzlaff Steffen Burzlaff

The Confluence Cloud mobile app is great for consuming, editing or creating content on the go. Confluence mobile app allows you to browse Confluence nearly the same way as on your desktop. In this video we're going to show you what the Confluence mobile app is capable of and how and when to use it the best way.

best-practice
Steffen Burzlaff Steffen Burzlaff

Do eyes droop while reading your carefully documented process? Give your Confluence pages a makeover and create pages with better readability with this guide to building beautiful pages.

best-practice
Steffen Burzlaff Steffen Burzlaff
Share this article
Reset Cookies

The following services will be reset and deactivated for you.

  • Typeform:
    We're using Typeform to embed quizzes and surveys into our website. By clicking "Disable all services" you're no longer able to submit quizzes or surveys on our website until accepting the service again.
  • Hyvor Talk:
    We're using Hyvor Talk as a comment tool. Hyvor Talk sets a local storage when activated. By clicking "Disable all services" you're no longer able to post or read comments on our website until accepting the service again.

By clicking "Disable all services" all cookies and local storages related to the services will be removed. Before using them on our website again, you need to accept them.