Configuration Assistant

The Configuration Assistant provides a fast, guided way for administrators to create a basic, bi‑directional Email This Issue configuration. With just a few clicks, you’ll get a randomly generated email address and all the supporting connections, handlers, and schemes you need to send and receive emails in Jira—perfect for evaluating the add‑on’s capabilities before rolling out a production setup.

📍 Accessing the Configuration Assistant

  1. Go to Apps ▶ Email This Issue in Jira.

  2. Click the Configuration Assistant button in the top menu bar.

You can access the Configuration Assistant in the top menu bar in Email This Issue

❓ How to use?

  1. Create a Test Configuration On the Configuration Assistant form:

    Field
    Description

    Name

    A unique name for your configuration. This helps you distinguish between multiple Configuration Assistant runs.

    Project

    Select a Jira project. The created configurations will only affect this project.

    Issue/Request Type

    Select an issue or request type. The created configurations will only affect issues with this type.

All fields are mandatory. The assistant uses your selections to scope:

  • Issue creation from incoming emails: When an email sent to the email address generated by the Configuration Assistant, an issue will be created in the selected project with the selected issue or request type.

  • Manual email availability: Emails can be sent for issues in the selected project with the selected issue or request type.

  • Comment notifications on issues: When someone comments on an issue in the selected project with the selected issue or request type, a notification email will be sent.

You can configure the scope of your configuration here
  1. Review Your Test Setup Once you click Submit, the assistant generates:

    Item
    What It Does

    Sends all Manual and Notification emails.

    Defines used template, format of the email (HTML/plain), default recipients, etc. for manual emails.

    Configures overrides for sender information, the ability to save recipients, and which mail connection to use.

    Controls when notification emails are sent and what they contain.

    Receives inbound messages into Jira; works with your Mail Handler.

    Rules for parsing incoming emails. For example: create new issues or add comments to existing ones.

You can review every configuration item created by the Assistant here
  1. Try It Out

    • Send an Email to your generated email address (e.g., [email protected]).

      • If the project/type selection allows issue creation, a new issue/request appears.

    • Add a Comment on the created issue: you should receive a comment‑notification email.

    • Manual Email: open the issue, choose Actions () ▶ Email to send a manual email.

⚠️ Limitations

The test email addresses generated by the Configuration Assistant are for evaluation and testing purposes only. Therefore, the following limitations apply:

  • Only supports up to 3 recipients per outgoing email

  • Expires and will be deleted after 30 days

  • In the Outgoing Mail Connection, the From Address cannot be changed

▶️ Next Steps

Last updated

Was this helpful?