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
Go to Apps ▶ Email This Issue in Jira.
Click the Configuration Assistant button in the top menu bar.

❓ How to use?
Create a Test Configuration On the Configuration Assistant form:
FieldDescriptionName
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.

Review Your Test Setup Once you click Submit, the assistant generates:
ItemWhat It DoesSends 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.
All items are fully editable—feel free to tweak settings, templates, or handlers as you explore.

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.
If the project/type selection contains custom configurations (like required fields besides Summary and Description) the issue creation may fail.
⚠️ 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
For production use, change the Incoming and Outgoing Mail Connection to use your own email service provider.
Please ensure this feature is NOT used in a production environment. The generated email addresses are intended solely for testing the product’s core functionalities. Activities such as sending a huge amount of bulk emails—including those triggered by bulk changes or automation—are outside the scope of fair use and are prohibited.
▶️ Next Steps
You can tune every configuration item to your liking. If you’re happy with the setup, you can transform these test configurations into production ones by editing your Incoming and Outgoing Mail Configurations to point to your real email address!
Last updated
Was this helpful?