Skip to main content
Skip table of contents

Smart Wiki Panels for Jira

What is a "Wiki Panel"?

The Wiki Panel is an additional panel in the issue view screen. The panel contains a list of links which are knowledge that is stored in Confluence and are specifically provided to assist the current user in the process of completing his/her task.

A Wiki Panel can be created by Jira Administrators/ Project Administrators and can be configured by them.

On this page

For all the following procedures,

  • Smart Panels for Jira app must be installed on your Jira Cloud with a license or trial license (see our Installation Guide for detailed instructions).

  • You must be logged in as a user with the Jira Administrators global permission.

Creating a new Wiki Panel

An Wiki Panel is specific to a single project or multi projects or global. If you want to reuse the configuration of an existing Wiki Panel, go to step Copying an Wiki Panel on this page.

  1. Choose :cog_icon: > Apps

  2. Navigate to Smart Panels for Jira Cloud

  3. Click Create Wiki Panel.

  4. Use the form to configure the following attributes and conditions of your panel (See the table below)

  5. Click Save and you will be redirected to the Manage Panels page.

Section

Parameter

Description

Additional Information

Required

Details

Name

Enter the name for the panel.

Use a self-explanatory panel name so users can understand the purpose of your panel.

Maximum 255 characters

yes

Description

Add a description of the panel.

Maximum 4096 characters

no

Scope

Select the scope where the panel will be displayed

Global: Apply for all Projects
Projects: Apply for specific project/s

yes

Project

To configure the field Project, the Scope “Projects” must be selected

Select the project where the panel will be displayed.

Multi-Select Field

yes

Issue Type

The Issue Types where the panel will be display, or All Issue Types if this field is empty.

Multi-Select Field
Default: “All Issue Types”

no

Content

Filter By

Select filter by CQL or BUILDER

Select type for wiki panel search

yes

CQL

Available when Filter By is set to CQL

Use CQL (Confluence Query Language) to search for issues.

CQL also support the Smart Value for configuration

BUILDER

Available when Filter By is set to CQL

Use CQL Builder UI to search for issues.
More details see below: Smart Wiki Panels for Jira | Builder

Max Contents

The maximum number of page/blog.. shown in the panel

Set -1 to indicate an unlimited number of contents

yes

Results per pag

The maximum number of contents shown in the panel for each page

Min: 1
Max: 100

yes

Columns

Select the metadata of the issue to be displayed. Optionally customize the header.

  • To add a new column, select a field from Add field input.

  • By default, field name will be used as the table header if the custom header is empty.

  • Use Restore default to restore the list of 4 pre-defined columns: Key, Summary, Status, Assignee

  • Use Reset previous (only when editing a panel) to undo every changes in the Columns list, and revert to the original columns before editing

  • Drag and drop a column to set the order of columns in panel view

  • To delete a column, click on the delete icon

yes

Permissions

Viewers

Grant permission to view the panel to certain groups, project roles, etc…

  • Private: Only viewed by the creator

  • User: Grant the view permission for specific users

  • My Organization: Any logged in user on the site

  • Group: Grant the view permission for specific groups

  • Project: Select project, project roles for viewing

yes

Supported issue field to show in Smart Wiki Panel

List of all supported issue fields to show in the Smart Wiki Panel.

Support Fields

  • Url

  • Title

  • Id

  • Status

  • Excerpt

  • Created

  • Creator

  • Label

  • LastUpdatedDate

  • LastUpdatedUserName

  • LastEditTime

  • SpaceKey

  • SpaceTitle

  • SpaceType

  • SpaceStatus

  • LikedPage

  • History

Constructing the CQL Query

In the section Content, we use CQL to construct the search query. The result of this search query is a list of issues that will be displayed in the Smart Wiki Panel.

  • Define your CQL in the CQL fields

  • Smart Values are supported when writing CQL. They enable dynamic searches based on issue-specific values. Learn more: Smart Values in Smart Panels

Builder

Use the link Add a filter to see all available filters. From the drop-down menu, select the relevant filter. The additional filter field can be removed via the cross button.

Parameter

Description

CQL parse

Text

Text field to search by text

text ~ “<input>“

In Space

Multi-select to search by Space

spaces IN (<input>)

With title

Text field to search by title

title~"<input>"

Label

Multi-select to search by Label

label IN (<input>)

Type

Multi-select to search by Type

type IN (<input>)

Creator

Multi-select users to search by Creator

creator IN (<input>)

Contributor

Multi-select users to search by Contributor

contributor IN (<input>)

Mentioning user

Multi-select uses to search by Mentioning

mention IN (<input>)

Created

Single select to search by created

createded >= <input> ,…

Last Updated

Single select to search by lasted updated

lastmodified >= <input>,….

Example of a CQL query with all criteria
CODE
'text~"text search" AND
space="space-1" AND
title~"hello" AND
label IN ("Bug","Feature") AND
type IN ("page","comment") AND
creator IN ("fdfd-1ae8-sde-b1e7-200117b81f85","5bd45e3d849b7be") AND
contributor IN ("ff8sd50c-1aeff8-44e2-b1e7-117b81f85","52sdsdba343d849b7be") AND
mention IN ("6285efef222d360ssdf7","1ae8-44e2-b1e7-200117b81f85") AND
created>="2025-12-16" AND created<="2025-12-23" AND
lastmodified>="2025-12-16" AND lastmodified<="2025-12-23" '

For the following procedures, at least one Wiki Panel must already exist.

For all the following Actions:

  1. Choose :cog_icon: > Apps.

  2. From section APPS, select Smart Panels for Jira Cloud.

The limitation of issues in the Smart Panels is 100 issues

Tip:

  • You can search your panels by Name or Scope.

Editing a Wiki Panel

  1. Locate the desired Wiki Panel and click :button_action: > Edit. / Or locate the desired Wiki Panel → click on the name

  2. On the Edit Panel page, use the form to configure the attributes and conditions of the panel (see the above table).

  3. Click Save and you will be redirected back to the Dashboard page.

Copying a Wiki Panel

  1. Locate the desired Wiki Panel and click :button_action: > Copy.

  2. The new copy issue panel will be added to the list of issue panels. The copy panel has a name with the syntax: "[original_name] - Copy”

Enabling/Disabling a Wiki Panel

  1. Locate the desired panel and click the toggle button Status

Removing a Wiki Panel

  1. Locate the desired Wiki Panel and click :button_action: > Delete.

  2. Confirm the deletion by clicking Delete.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.