Customize the login gadget in Jira server
The information in this page relates to customisations in JIRA. Consequently, Atlassian Support cannot guarantee to provide any support for the steps described on this page as customisations are not covered under Atlassian Support Offerings. Please be aware that this material is provided for your information only and that you use it at your own risk.
Also, please be aware that customisations done by directly modifying files are not included in the upgrade process. These modifications will need to be reapplied manually on the upgraded instance.
Purpose
In some usage scenarios, you may want to include a customized message on JIRA's login gadget to include messages you'd find useful or remove certain elements. Since there's no way to modify the gadget through JIRA's interface, you'll have to manually edit its source files.
Process
Always remember to backup the files you modify so you can rollback in case anything goes wrong in the process.
- For JIRA 6.4 and above, the plugin file will be in the
<jira-install>/atlassian-jira/WEB-INF/atlassian-bundled-plugins/folder. Create a temporary folder and extract the
jira-gadgets-plugin-<version>.jarfile there:jar xf jira-gadgets-plugin-6.4.13.jar- Until JIRA 6.4, you can modify the
login.xmlandlogin-gadget.soyfiles. For JIRA 7, the file to be modified is onlylogin.soy. Create a new JAR container after modifying the files and name it the same as the original JAR file (e.g.
jira-gadgets-plugin-<version>.jar).jar cvfm jira-gadgets-plugin-6.4.13.jar META-INF/MANIFEST.MF ./*- Restart JIRA.