Document toolboxDocument toolbox

Build your first Simple Search

Owned by Becky Schwartz (Unlicensed)
Last updated: Oct 11, 2023
2 min read

Jira

  1. Click Add gadget while editing a dashboard and type Simple Search in the search

  2. Select the Custom Charts Simple Search gadget from the list

  3. Go to the newly added gadget, and edit the Source field to choose which issues will be included in the linked charts

  4. On the right side of the gadget, find the Simple Search fields section, then click + Add another field

  5. In the dropdown that appears, select an option to add as a Simple Search field

    1. You can choose any Jira field, saved Jira filter you have access to, and write your own custom JQL. Repeat until you have all desired Simple Search fields added

  6. In the bottom right corner of the gadget, click Save

Confluence

  1. While editing a page, click +Ë… in the editor and type Simple Search in the search

  2. Select the Custom Charts Simple Search macro from the list

  3. Edit the newly added macro, then edit the Source field to choose which issues will be included in the linked charts

  4. On the right side of the macro, find the Simple Search fields section, then click +Add another field

  5. In the dropdown that appears, select an option to add as a Simple Search field

    1. You can choose any Jira field, saved Jira filter you have access to, and write your own custom JQL. Repeat until you have all desired Simple Search fields added

  6. In the bottom right corner of the macro, click Insert

For all Custom Charts and Issue List gadgets added after Simple Search, the Source will automatically set to Simple Search for easy connection!

The steps below must be followed if you add Simple Search after Custom Charts or Issue List.

  1. Navigate to the Custom Charts or Issue List gadget you want to use your Simple Search filters on

  2. With the gadget in Edit mode, click the Source dropdown and select Simple Search Gadget

  3. In the 2nd dropdown, choose the Reference ID of the Simple Search gadget you’ve just built

    1. If you only have 1 Simple Search gadget on your Dashboard, you should only see one reference ID

  4. In the bottom right corner of the gadget, click Save

For all Custom Charts and Issue List macros added after Simple Search, the Source will automatically set to Simple Search for easy connection!

The steps below must be followed if you add Simple Search after Custom Charts or Issue List.

  1. Navigate to the Custom Charts or Issue List macro you want to use your Simple Search filters on

  2. With the macro in Edit mode, click the Source dropdown and select Simple Search Macro

  3. In the 2nd dropdown, choose the Reference ID of the Simple Search macro that you’ve just built

    1. If you only have one Simple Search macro on your page, you should only see one reference ID

  4. In the bottom right corner of the macro, click Insert