Customize the login gadget in Jira server

Still need help?

The Atlassian Community is here for you.

Ask the community

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

(warning) Always remember to backup the files you modify so you can rollback in case anything goes wrong in the process.

  1. For JIRA 6.4 and above, the plugin file will be in the <jira-install>/atlassian-jira/WEB-INF/atlassian-bundled-plugins/ folder.
  2. Create a temporary folder and extract the jira-gadgets-plugin-<version>.jar file there:

    jar xf jira-gadgets-plugin-6.4.13.jar
  3. Until JIRA 6.4, you can modify the login.xml and login-gadget.soy files. For JIRA 7, the file to be modified is only login.soy.
  4. 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 ./*
  5. Restart JIRA.
Last modified on Sep 25, 2019

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.