Skip to end of metadata
Go to start of metadata



  • JIRA Version 6.4.6
  • Applications in JIRA linked to a Confluence (Application Links User Guide)
  • The linked Confluence has to allow for anonymous read access to the Knowledge Base Space


  • The Knowledge Base Custom Field for Service Desk is a user defined field, which can be used in JIRA issues. JIRA Service Desk is not required.
  • A Confluence Knowledge Base (a Confluence Space) can be searched for articles (pages) via this field. Search results can be presented as a list in the Knowledge Base Custom Field.
  • In addition, it is possible to display standard Knowledge Base articles independent of the search term. These articles are displayed whenever they are marked with a Confluence label as defined in the Knowledge Base Custom Field.

The following image shows the results of the search "I cannot login":

The Knowledge Base Articles that are found can be used from a Knowledge Base Custom Field in a reply to a customer. The article can be included as wiki markup link in the response field via a click. 

View Wiki markup Draft

View Wiki markup Preview


Configuration of the Knowledge Base Custom Field

  1. Before the Knowledge Base Custom Field can be created and configured, a Confluence instance needs to be linked (Application Links User Guide).

    If you use JIRA Service Desk and your Service Desk userbase did not have access to confluence you must enable anonymous access to the Knowledge Base Space in Confluence. 
    In Confluence the anonymous access has to be activated globally for the instance, and the Knowledge Base Space (How to give non Confluence users access to a Space). 
    Activate global anonymous access: Confluence Administration > User & Security

    Activate anonymous access for the space: Space configuration (of the Knowledge Base Space) > Rights

    If you share the same userbase between JIRA and Confluence you can configure the Application Link to use OAuth with Impersonation (OAuth security for application links). In this case you don't need to activate anonymous access in your Confluence instance.

  2. The Knowledge Base Custom Field needs to be created as a custom field (search for Knowledge Base Custom Field). After creating the Knowledge Base Custom Field, it needs to be displayed in the screen masks of your project. For the field to be displayed in the issue, the screen mask of the project has to be selected. 

    For Service Desk projects: In addition, the mask "To Customer - x" has to be selected for the customer response dialogue, so that the Knowledge Base articles can be used as answer or commentary. The mask can be identified via the workflow of the ServiceDesk project. Click on "Respond to Customer" in the workflow of the Service Desk Project, as illustrated in the image below.

  3. Finally the Knowledge Base Custom Field needs to be configured: Administration > Issues > User Defined Fields > Name of the Knowledge Base Field > Options > Configuration

Application Link 
(required field): Configuration of the linked applications. Select the Confluence with the Knowledge Base Space.
Knowledge base spacekey (required field):
 Enter the Confluence Space Key of the Knowledge Base. You can configure more than one Confluence Space (comma separated e.g. KB, KBINT). If you configure more than one space you get search results from any configured space. If you did not insert a spacekey, you get search results from any space. 
Max. number of knowledge base article results:
 The option "Edit Max. number of knowledge base article results" determines the number of search results (0 for unlimited). Standard knowledge base articles are not taken into consideration.
Standard Knowledge base Article:
 The option Edit Default Knowledgebase Article defines a Confluence Label. All knowledge base articles with this label will be displayed, independent of the search term.

Diese Seite auf Deutsch lesen.

  • No labels

This content was last updated on 07/05/2017.

This content hasn't been updated in a while. That doesn't have to be a problem. Some of our pages live for years without becoming obsolete. Please click this link if you want us to update this page. Old content can be incorrect, misleading or outdated. Please get in contact with us via a form on this page, our live chat or via email with if you are in doubt, have a question, suggestion, or want changes from us.