ScriptRunner allows you to customize the UI of Jira by adding buttons or displaying web content on a page.

Web Panels

Web panels can be used to add HTML snippets to parts of a page.

You can use Web Panels to display additional information on the current wiki page, or Jira issue etc.

For more information about web panels see Atlassian’s documentation.

Due to certain limitations, no more than two fragments can be displayed in a single location.

How to Use Script Fragments

Script Fragments example.


  • Navigate to the Script Fragments section in the ScriptRunner menu

  • Click on Add fragment

  • Select the space where you want the fragment to appear

  • Select the location that you want the item to appear in.

  • Select either the Render External or HtmlCssJs options int he Rendering Mode dropdown

    • The Render External option will link a webpage to your web item, displaying it in a pop-up box where the Web Panel is located

    • The HtmlCssJs option will allow you to inject an HTML URL, CSS and JavaScript into your button

  • If you’ve selected the Render External option, add your target URL

  • If you’ve selected the HtmlCssJs option, add your HTML URL, CSS URL and JavaScript URL to the Web Panel

  • Click Save changes

The HTML, CSS and Javascript has to be hosted somewhere that Jira can access. We recommend CodePen for the hosting. It’s also important to note that the hosting must serve up the matching content-type header for each file.

Web Panel Display with External Resource

Web Panel Display with External Resource example.

Web Panel Display with Specified HtmlCssJs Resources

Web Panel Display with Specified HtmlCssJs Resources example.