You can now vote for scripts to help people know if they're useful or not. Login or create an account to vote!


Send Release Notes to Issue Stakeholders


Send a list of issues in the release version to their reporters, assignees, or custom field members (issue stakeholders). Each stakeholder receives a release note of issues they are involved in.


As a project manager, I want stakeholders to be informed once a new version is released. I can configure this script to send a customisable email to the reporters of each issue.

Good to Know

  • This script requires Email This issue plugin.
  • Associate this script with the VersionReleasedEvent event listener.
  • Build you own email template using Email This Issue's Template editor.


  • ScriptRunner for Jira ScriptRunner for Jira (5.6.14)
import com.atlassian.jira.component.ComponentAccessor import com.atlassian.jira.event.project.VersionReleaseEvent import import com.atlassian.jira.web.bean.PagerFilter import com.onresolve.scriptrunner.runner.customisers.WithPlugin import com.onresolve.scriptrunner.runner.customisers.PluginModule import com.metainf.jira.plugin.emailissue.api.EmailService import com.metainf.jira.plugin.emailissue.api.EmailDefinitionApi import com.metainf.jira.plugin.emailissue.action.EmailOptions import org.apache.log4j.Level log.setLevel(Level.INFO) @WithPlugin("com.metainf.jira.plugin.emailissue") @PluginModule EmailService emailService // Get the released version from the associated event final version = (event as VersionReleaseEvent).version // Name of the template to use final templateName = 'Release Notes - per reporter' //Get reference to Jira API def issueManager = ComponentAccessor.issueManager def user = ComponentAccessor.jiraAuthenticationContext.loggedInUser def searchService = ComponentAccessor.getComponent(SearchService) // Find issues for the version being released def jqlString = "fixVersion = ${} ORDER BY issuetype, priority DESC, key ASC" def parseResult = searchService.parseQuery(user, jqlString) if (!parseResult.valid) { log.error("Invalid JQL: ${jqlString}") return } def searchResult =, parseResult.query, PagerFilter.unlimitedFilter) def issuesInVersion = searchResult.results.collect { issueManager.getIssueObject( }"Issues in version " + issuesInVersion) // Group the issues by reporter def issuesByReporter = issuesInVersion.groupBy { issue -> issue.reporter }"Issues by reporter: ${issuesByReporter}") // Loop through the reporters and send the list of their issues to them issuesByReporter.each { reporter, reporterIssues -> if (!reporterIssues) { return } // Recipient is the reporter only, but other stakeholders could also receive the emails def recipientsTo = [reporter.emailAddress] // Compose parameters for Email This Issue def email = new EmailDefinitionApi() = recipientsTo email.emailOptions = new EmailOptions() email.emailOptions.emailFormat = 'html' email.emailTemplate = templateName // Payload is a key-value pair to populate email templates def payload = [issues: reporterIssues, version: version, reporter: reporter] email.payload = payload // Send the email try { emailService.sendEmail(email) } catch (Exception e) { log.error("An exception was thrown: ${e.message}") } }
Discovered an issue? Report it here

Suggested for you

Appears in these Collections