Tips & Tricks

This page contains useful tips to create themes that will be compatible with future versions of JIRA and Confluence:


Learn from existing Extensions

Look into the Sample Extensions to see how other extensions work. And read the detailed blogpost about how the "Language Switcher Extension" has been built.

Increase the probability of compatibility for your extension

  • Styles
    • Use the very common html containers of the application:
      • #header
      • #footer
      • #main
    • Do not style into the very little end of the applications html
    • Do not rely on a specific container hierarchy:
      • #div1 > h1 > ul > li > a
    • Each style needs to have a specific context id to start
      • #header .examplediv
      • #main #examplediv
  • Javascript
    • Use only one "AJS.toInit" function as a kind of "main" function
      • call up all your container move functions from this function
  • Template
    • Create a specific container div id to include your backend code:
      • <div id="my-special-unique-container" ></div>


  • If your Template content is not available in the html
    • search the html for "Error during template resource parsing!"
    • If this string is present please check the logs for further information

Scope your Template HTML 

If your Extension HTML should only be available in certain pages 

  • You can scope the Template code to a specific action or URL
## example HTML only for Dashboard
	your scoped HTML
## example HTML only for Dashboard
	Your HTML code

  • Your can Scope your Application to a specific Context
## example HTML only for space with key "ds"
	your scoped HTML

## example HTML only for project with key "DEMO"
	Your HTML code