Add Email as Jira Comment

Once the installation and configuration of the add-in is completed, an email can be added as comment to a Jira issue directly in Microsoft Outlook. This function can also be used to add email attachments as attachment to an existing Jira issue. 

To add an email as Jira issue comment, do the following:

  1. Select the email you want to create a Jira issue from.

    By default the body of the email is used as comment text. If you select a part of the email body's text, only the selected text is used as comment text.

    Then select Add as Comment from the Outlook menu or from the email's context menu.

    The following dialog will appear:

  2. Select the project you want to comment, from the Select a project menu. If you do not know the project, select Global search from the menu.

    If the subject of an email contains a valid Jira issue key and the issue is visible to you in Jira, the issue will be automatically selected in the dialog.

  3. To limit the search scope, you can do the following:
    • Do an pattern search. Enter a search pattern in the Issue search pattern text box and click Search.
      By default the issue summary, description and all comments are searched. You can specify the search scope by selecting and deselecting the "Search scope" options:
      • Summary
      • Description
      • Comment
    • Search for an issue key. Enter the issue key in the Issue Key text box and click Search. If you want to search for multiple issues, you can separate them by comma.
    • Search for an issue status. The statuses that are available for the selected project are listed in the Only issues in the following status listbox. Select the status you are looking for from the menu. To select more than one status, click on a status using the left mouse button. Click again to unselect the status.
    The matching issues are listed in the Select an issue listbox.
  4. Select an issue from the Select an issue listbox.
  5. The Comment textbox is pre-filled with the email body respectively with the selected email text. If needed, you can modify the content.

    To add the header information of the email to the issue description, select Add header information. 

     To select the Add header information by default, select Auto add e-mail header information at Advanced Configuration > Common.

    By default the email header information is not copied into the Jira issue. When you select this option, the header information is also used for the Jira issue description.

  6. A list of the files that are attached to the email is displayed in the Attachments frame. Select the files, you want to attach to the Jira issue.

    To add the email as attachment to the Jira issue, select Add e-mail as attachment.

    To select the Add e-mail as attachment by default and specify the file format of the attached email, select Always add e-mail as attachment at Advanced Configuration > Common.

    If you want to link the comment within the description, please use [^mail] as placeholder.

    If you want to add only the email attachments without adding a comment, select Only add attachments.

  7. To add the comment and/or attach the files to the Jira issue, select Add.