Embed video
best-practice

Using Labels in Confluence – Order Is Half the Battle

Confluence labels are a simple but powerful feature to categorize your content. Here are some reasons why we at K15t love working with labels:

  • To group pages that belong together, but exist in different spaces or hierarchies.

  • Labels are easy to add and remove without changing any content on the page.

  • There's no limit to labels, you can add them to pages, attachments or spaces.

  • Labels are user-defined and can be aligned to a use case, user group or other category. 

blog-post-teaser-image-using-labels-in-confluence-color-blues-b200.svg

Start With a Label System 

Labels can be added to pages, attachments and even spaces to structure your content. Before you start using them, develop a label system with a clear set of rules. This helps everyone in the team to comply. Here are our recommendations:

Use naming conventions

Naming conventions help keep your labels clean and consistent. 

  • Use abbreviations and prefixes: Define if and how you will use abbreviations and prefixes, such as 'kb' for knowledge base articles or 'how-to' for step-by-step guides. 

  • Stick with singular: We recommend naming labels in singular form only. Otherwise you end up with 'project' and 'projects' and you won't know which is the correct one.

  • Keep it simple: Don't pack too much information into a label. Stick to single or short multi-word phrases, such as 'admin' or 'knowledge-base'.

  • Separate your words: Make it clear how to separate words. A hyphen or underscore are the most common separators.

For your naming system, it's helpful to use commonly used search termsTake a look at your Confluence analytics – if you work with Confluence Cloud Premium or Cloud Enterprise – to find out what other users are searching for. You'll find a list of search terms and can decide whether your existing label names suit what your users search for.

Or take a look at Google Analytics to find what keywords your customers use. This can also help improve how you name your labels.

Define a label manager

Appoint a person to regularly monitor the system to ensure that all defined rules are being followed. Have you already designated a Wiki Gardener for your Confluence spaces? Then perhaps this person can take on this task too.

Here are some tips that help a label manager to keep track of how labels are being used.

Create an alphabetical list of your labels

Use the Label List macro to receive a list of all your macros in an alphabetical order to spot typos and other irregularities easier.

  1. Go to edit mode, click on image2021-6-17_10-47-4.png.

  2. Filter for Label list.

  3. Define a space key or exclude particular labels, if needed.

You also see this overview if you type https://your-domain/labels/listlabels-alphaview.action.

Create a heatmap

See which labels are most frequently used within a particular Confluence space by creating a heatmap.

  1. Go to edit mode, click on image2021-6-17_10-47-4.png.

  2. Filter for Popular Labels.

  3. Define a space key and a number of labels that should be displayed.

RTD-Lables-in-Confluence-heatmap.png

Use Cases for Labels

If you use Confluence and page labels, you have access to different macros that improve the usability of your documentation.

Better search results

With the Livesearch macro, you can add a search field to your documentation. You can narrow down the search results that are output via this macro to specific labels beforehand, so that your users only get the information they really need.

  1. Go to edit mode, click on image2021-6-17_10-47-4.png.

  2. Filter for Livesearch macro.

  3. Fill out parameters such as space key, restrict to labels or content types or add a placeholder text.

RTD-Lables-in-Confluence-livesearch.png

Group a specific set of content

Your Confluence pages are probably clearly structured within one or more spaces. However, in some cases, pages cannot be clearly assigned and fit into multiple topics. For this case you can use the Content by Label macro. Enter one or more labels and the macro will automatically create a list of pages where these labels are used.

We use this macro to show related articles on our help center to list knowledge base articles that are actually not part of the documentation page tree, but that still provide useful information for the reader about specific topics.

RTD-Lables-in-Confluence-group-content.png

Filter for attachments 

Using Confluence pages is more than just writing plain text content. You can also add attachments such as images, proposals, contracts or other documents as PDF, image file, Word file or other document file formats. Therefore it makes sense to label relevant attachments as well.

  1. Go to the page that contains the attachment and click Attachments

  2. Select the attachment, click on the label sign image2021-7-2_10-44-32.png and add your label.

The quick search bar in the top right corner of a Confluence page allows you to quickly find specific attachments using the combination of Content Type attachment and the corresponding Label.

If you manage many attachments and need a better overview of them, you can create a list using the Content by Label macro.

RTD-Lables-in-Confluence-filter-attachments.png

Tell Us Your Use Case

There are so many great ways to use labels for your documentation in Confluence. What is your favorite?  Drop us an email and let us know how your team works with labels.

Embed comments

Read on..

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

"Sorry, what was the name of that page again?" Here are some tips to help make sure your Confluence pages are found quickly and navigated in the right way.

best-practice
Steffen Burzlaff Steffen Burzlaff

If your team uses Confluence, you’re probably creating really great content together. And you know what people do with good content, right? They copy it! While it’s important to put valuable information where people need it, Confluence provides a much better way of spreading great content than the simple “copy and paste”. In this video, we explore how to reuse your content throughout your pages and spaces so your team always has the most up to date information, everywhere.

best-practice
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 video
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.