Set up your knowledge base
A knowledge base in Jira Service Management helps customers find answers through self-service and gives agents relevant solutions while resolving requests. You can connect Confluence, Google Drive or Microsoft SharePoint.
You can link more than one knowledge source to a Jira Service Management knowledge base. This lets your help center, knowledge base search, and Virtual Service Agent use content from native Confluence spaces, cross-site Confluence spaces, and third-party folders at the same time. and allows users to access core knowledge base capabilities at no extra cost.
When you set up the knowledge base from the sidebar of your service project and don't already have Confluence on your site, the knowledge base is enabled with default settings at no extra cost for the free plan. All the features your team needs for knowledge management will be available directly in your project, and your team can start creating articles immediately.
The availability of sources, Rovo, cross-site Confluence linking, and third-party connectors depends on your plan and organization permissions.
Some of the key features of your knowledge base that you can access at no extra cost include:
Create new space
Create, edit, and delete knowledge base articles
Manage space permissions
Manage knowledge base permissions for your site
Manage anonymous access
If you make annual payments and want to access the core knowledge base capabilities powered by Confluence, please contact your Billing admins to get Free product access to Confluence for up to 1 user on your site. Read more about users and user tiers.
Before you begin
Knowledge source | Requirements |
|---|---|
Confluence on the current site | Jira Service Management project administration permissions. If Confluence is not active on the site, setup may activate the free core knowledge base capability. |
Confluence on another site | Project administration permissions and access to the target site and Confluence space. |
Google Drive or Microsoft SharePoint | An organization administrator must connect and authorize the application and allow content indexing. Project administrators can then link indexed folders. |
Create with Rovo | An eligible Atlassian plan with Rovo enabled for your organization. |
Set up your knowledge base
To get your knowledge base up and running:
In your space, select Knowledge base and follow the instructions to finish the setup. After you complete the setup, a space with the same name as your project is automatically created.
(Optional) You can also create a new space for your knowledge base.
Next to the name of your space in the sidebar, select More actions (•••), then Space settings.Select Channels & self service, then Knowledge base. Then, select Create space and enter the required details.To view or manage permissions for a space, go to Knowledge base in your Project settings. Find out how to manage permissions for your knowledge base space.
Open knowledge base settings
Go to your Jira Service Management project.
From the project sidebar, select Knowledge base.
Select Set up knowledge base. You can also select Set up with Rovo to create initial content with AI.
Choose a content source
The setup window displays the available sources:
Confluence
Google Drive
Microsoft SharePoint
Connect Confluence
Select Confluence.
Select Create or link existing content.
Choose the site and space to use for your knowledge base.
Select Next or Link to complete the connection.
If Confluence is not active on your current site, Jira Service Management may automatically configure the free core knowledge base capability. If Confluence is already available, you can select an existing space or create a new space.
To connect content from another site, use the site selector and choose a site and space that you can access.
Connect Google Drive or Microsoft SharePoint
Select Google Drive or Microsoft SharePoint.
Review the connector status and indexing progress.
Select the folders containing the documentation you want to make available.
Click Link button to link the folders to your service project.
Organization authorization required: An organization administrator must connect and authorize Google Drive or Microsoft SharePoint before a project administrator can link folders.
If the source is not connected
Organization administrators: Open Atlassian Administration (admin.atlassian.com) and connect and authorize the relevant application.
Project administrators: Ask your organization administrator to connect the application and enable content indexing.
If the connector needs attention
A warning or unhealthy status can indicate that authorization has expired or permissions have changed. An organization administrator must re-authenticate the connector in the organization administration settings before you can select folders.
Create content with Rovo
Select Create with Rovo, or select Set up with Rovo from the knowledge base landing page.
Describe the content you want to create, such as FAQs, troubleshooting guides, or starter articles.
Review and edit the generated content.
Publish approved articles to the knowledge base.
Review AI-generated content for accuracy, security, and suitability before publishing it to customers.
Manage users who get free product access to Confluence
To continue using the knowledge base in Jira Service Management at no extra cost, ensure that the total number of users getting product access to Confluence is always zero. If you add more users, you will be required to pay for product access to Confluence after the trial period is over.
Learn more about Confluence Cloud plans.
To remove user groups in Confluence:
Go to admin.atlassian.com.
If you're an admin for multiple sites or an organization admin, select the site's name to open the Atlassian administration for that site.Select Products from your top navigation.
Find Confluence and select More actions (⋯).
Select Manage product access.
Under Group, select the groups that you want to remove. For example, you can remove site-admins groups to ensure that new users won’t automatically get product access to Confluence.
Select the More actions (⋯), and then select Remove group from product.
Refresh the page to confirm that your site does not have any billable Confluence users.
If the group you want to remove is a default group, you’ll find that the Remove group from product option is disabled. In this case, you’ll need to select the group, and then select View group’s details. It will take you to the Groups page where you can view and remove individual users from that group.
Read more on how to remove Confluence product access for users in your site.
Switch to a different Confluence plan
You can always assess your team’s requirements, check how many of your users need product access to Confluence, and adjust your plan accordingly.
Was this helpful?