Custom events

Still need help?

The Atlassian Community is here for you.

Ask the community

As a JIRA administrator, you can set up a custom event to trigger an email notification for a custom workflow transition.

Configuring notifications for a custom event

Custom events are most commonly used to generate notifications for custom workflow transitions. For example, your organization might need you to modify the default workflow by adding a workflow step called QA_Inspection (e.g. between Resolve Issue and Close Issue). You would typically also need to generate an email notification to the QA team whenever an issue progresses to the QA_Inspection step of the workflow.

There are three overall steps to achieve this:

  1. Add a custom event to the system (e.g. Issue Awaiting QA).
  2. Configure the notification scheme to send an email when the custom event is fired.
  3. Configure the workflow transition post function to fire the custom event.

How to add a custom event

  1. Choose the Jira icon (, or ) > Jira settings > System
  2. In the Advanced section, click Events.
  3. In the Add New Event section, add a name and description for the custom event.
  4. Select the default email template to be associated with the event.
  5. Click Add.

The custom event must be associated with a default email notification template. A notification scheme configured to notify users of this event will use this email template when sending the notification.

The custom event will appear in the list of events defined within the system. Initially, the event will be marked as inactive, as it is not associated with a notification scheme or workflow post function.

How to configure the notification scheme to send mail

  1. Choose the Jira icon (, or ) > Jira settings > System
  2. In the Advanced section, click Events.
  3. Select the notification scheme to edit, by clicking the notification scheme's name or its Notifications link (under Operations).
  4. Add the recipients for the custom event as needed.

How to configure a post function to fire the custom event

  1. Select the Jira icon (, or ) > Jira settings > Issues.

  2. In the Workflows section, click Workflows.
  3. Find the workflow transition post function screen to be edited.
  4. Update the post function to fire the custom event.
  5. Activate or associate the workflow (and scheme) with the appropriate project.
Last modified on Jan 20, 2017

Was this helpful?

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