Activate custom email templates without restart JIRA - How to?

Hi All,

we created a bunch of new emial templates and we would like to activate them to go on with the work (creating custom events, etc.). In earlier Jira version (major v4) it was possible to change the templates without server restart. We use now v5.2.8 and I'd like to ask you how to activate these email templates without restart?

It is fundamental because our Jira is used 0-24 so a restart is recommended to avoid.

Thanks in advance for help!


2 answers

1 accepted

0 votes
Answer accepted

As far as I know, velocimacro.library.autoreload tell Jira to reload and not cache any velocity template. So this may help you if you're changing existing templates that you've already deployed.

But unfortunately, to change this setting you must restart Jira. Also, you must map the events to the velocity templates so it-s necessary to edit the email-template-id-mappings.xml file, and restart jira again.

So ... you-ll need to restart at least 1 time the first time you deploy the templates ... then you can modify these templates without restarting


Thanks for the hint!


Just don't forget that you will need to restart your production service regularly, before it chokes up the cache and dies.

You may also experience odd pages going wrong due to this change (with increasing frequency as time goes on between restarts), although they should be fine if the users seeing them simply refresh the page.

Hi Nic,

actually I need to restart JIRA at least one time for uploading the email setttings to the events. I changed the as detailed above but nothing happened.

You're missing the point - you are going to need to keep restarting your Jira, regularly and frequently.

If you've changed the properties file and restarted, then I don't understand why it wouldn't work - it does here on Test, although I needed to do it twice, and that was after I realised I'd put the wrong owner on the file (must stop doing "sudo bash")

Hey Rumi,

check the docs:

Deploying Velocity templates without restarting JIRA

In a development instance, you can play with picking up velocity file changes without a restart.
From <jira-install>/atlassian-jira/WEB-INF/classes/

  1. Change class.resource.loader.cache from true to false
  2. Remove the comment sign (#) from #velocimacro.library.autoreload=true

Making this change in production will eventually lead to JIRA not serving pages along with the ran out of parsers error in the log file.


Bother you beat me to it.

I was going to say "you can't do this in 4 or 5 without running out of resources, so you should not really have done it in production in your old version, let alone version 5". Also, you need to restart Jira to pick up the changes in that properties file too...

Thanks for the hint!


Suggest an answer

Log in or Sign up to answer
Community showcase
Published Thursday in Jira

Updates to give you visibility into what's coming in Jira Server and Data Center

Hello, Community! My name is Gosia and I'm a Product Manager on Jira Server and Data Center here at Atlassian. Since 2002 when we launched our public issue tracker, jira.atlass...

291 views 1 12
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you