How to Use Confluence as a Knowledge Base

I recently completed an implantation of Workday HCM, Finance, and Payroll.  One of the many project responsibilities I had was to run cutover and organize product support.  Early in the project, I determined using Jira, Jira Service Management and Confluence would help us have a successful implementation.   


Lots of Questions

While preparing for the project and discussing implementations with other institutions I learned that they all struggled with the number of support tickets that flooded in after go-live.  I learned that majority of the questions could be answered through basic knowledge base articles.  This led to the creation of a robust knowledge base to address these questions.


Create a Framework

Once I knew that we would be focusing on training our customers to answer their own questions I created a knowledge base framework that could be easily followed and would ensure the information could be found.  I created the following:

  • A Workday Knowledge Base in Confluence
  • A template that all knowledge base articles would use
  • A guide for creating articles, the guide included
    • How to create an article
    • Sections that each knowledge base article should have a detailed description of what must be included in each section:
      • Title
      • Summary
      • Body
      • Last Updated Information – This was atomically added through a macro but I let individuals know not to delete it.
      • Labels
      • Guide for using images
      • Guide for using macros
    • A process for releasing articles
      • A review process was implemented that ensured
        • The title is clear and concise
        • The article has a summary
        • The body has been formatted well
        • Labels have been applied
  • A label guide. The guide had to be followed to ensure that articles could be associated with the proper request types in the service desk and easily organized by subject matter.  The labels also allowed the automation of relating content within the knowledge base.   


Once the framework was in place, I held training sessions so individuals creating the articles would know what the expectations were for each article and ensure that they were familiar with the resources.  As part of the training, individuals brought information to create their first knowledge base article and I assisted them in a working session at the end of the training.  This provided confidence since they already created their first article in the training and were now familiar with the process.


Create Knowledge Base Articles NOW!

Early in the project, I began having individuals produce knowledge base articles.  This allowed a large repository of articles to be created before Workday went live.  The articles were also used during validation and updated based on feedback from those performing the testing.  I was also able to catalog knowledge base articles that were missing so those could be created before our go-live. 



Connect Your Articles to Your Service Desk

Once a large knowledge base was in place, I correlated them to our service desk request types using the labels associated with each article.  This helped ensure that if individuals did not find the answer during their initial search, they would hopefully find it before submitting a support ticket. 



Have Additional Training

A month before go-live we began training individuals on how to find answers in the knowledge base.  Weekly sessions were held with hundreds of employees attending each session.  They were provided with information about how to submit a service desk ticket and how to find answers in the knowledge base. 


Continue Addressing Questions With Knowledge Base Articles

At go-live, the Workday Knowledge Base contained close to 300 articles.  After going live articles have been consistently added to address frequently asked questions or to provide information about new features or processes that are regularly implemented.  By monitoring the service desk, I can identify articles that need to be created or issues that need to be addressed.   It is important to ensure that you have resources in place to do this ongoing work.


Rewards of a Job Well Done

In the first year after Workday went live 26,530 tickets were submitted.  This is half the number of tickets our sister institution had in the first three months after go-line and they only launched Workday HCM.  Out of the tickets submitted 3,878 were resolved by the agent just sharing a knowledge base article with the customer.  (This improved as I did additional training with the agents on how to quickly do this.)  Our approval rating was 4.8 out of 5 and SLAs were met 83% of the time.  In the first year, we had over 138,000 knowledge base articles used to answer users’ questions. 

If there was no knowledge base in place there could have been over 150,000 support tickets submitted in the first year.  Our small support team would have had to handle this number of tickets.  Because we had a knowledge base, we had a manageable number of service desk requests allowing us to focus on real issues impacting the system.

created vs resolved.PNG


  • Build a knowledge base to assist users in finding answers to their questions
  • Implement a framework that individuals creating articles need to follow to ensure consistency in knowledgebase articles, searchability, and readability
  • Have a review process to enforce framework standards and to help keep articles updated as information changes
  • Train users on how to use the knowledge base
  • Go live and continue to add to and improve the knowledge base


Additional Resources




Pramodh M
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
September 10, 2022

Very well structured & a Good Article, Thanks @Brant Schroeder !!

Alessandro Mazza September 14, 2022

Great article!
@Brant Schroeder have you find a way to understand which are the most useful articles to solve requests? A KPI like “number of resolved issues using the article XYZ”?

Brant Schroeder
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
September 14, 2022

@Alessandro Mazza I was actually on a call today discussing this, specifically how we can improve the basic reporting provided in Jira Service Management.  There is reporting to assist with this but it is driven by agents and users.  We recently kicked off a campaign to ensure that both agents and users were using the tool in a way that assists with this.  On a monthly basis, we would have 12-18 issues resolved by a KB article by an agent based on the delivered reports (Article Effectiveness).  This has to do with how the agent provides an answer to the issue.  We did training with the agents and saw an immediate increase.  We expect this to improve through future training and follow-up with the agents.  The article usage and article effectiveness report also provide a metric problem solved by articles.  This is based on user feedback.  We are preparing to do an educational campaign with the users to help educate them on providing feedback through the KB articles.  This will in turn help us understand which articles are answering questions and answer questions like the one you proposed.  

Caitlin Steel May 16, 2023

Do you have any suggestions on how to best go to the next step of providing contextual help within the application that is linked to your knowledge base?  
I would love to use Confluence to be the single source of truth and yet support my customers more directly with easy to grab help!

Brant Schroeder
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
May 16, 2023

@Caitlin Steel That really comes back to your team and how you construct your KBs, use labels, request types, etc.  You should know your customer and how they seek out information.  You can use analytics to assist with this and refine all of the areas mentioned above to improve your setup.  

Like Andy Gladstone likes this
Caitlin Steel May 16, 2023

I get that... I am more wondering if there is a way to use Atlassian to support the end to end process without having to purchase another tool to support!  I have a new SaaS product that I want to support in-app help and contextual help and I dont want more than one set of information!

Looking for how others have done and/or best practices / suggestions!

Brant Schroeder
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
May 16, 2023

@Caitlin Steel The only real way to get information out of Confluence into another application is using the APIs or an app like you mentioned.  

Like Caitlin Steel likes this


Log in or Sign up to comment
AUG Leaders

Atlassian Community Events