To submit a Squish issue via email, first login to Squish and click New on the project navigation menu. Select the issue type which you will be submitting via email. At the bottom of the page, there will be a link to the correct email address. When you select that link, a new email will open with the correct Issue Type prepopulated in the subject line.
When you send an email to Squish to create a new issue, a number of things happen:
- To determine which user to submit the issue as, Squish checks the senders email address against all active company users.
The subject line is checked for the name of an issue type in square brackets.
- If an email address is associated with more than one user, the last user to log into Squish is used.
- If no user is found with the senders address, no issue is submitted.
The user is checked against the project role permissions for that issue type to make sure they have permission to submit issues.
The entire contents of the email are submitted as the description of the issue.
- For instance, to submit an issue of type "Feature Request" via email, the subject should include "[Feature Request]" in it. A subject of "[Feature Request] New feature name" will result in a new Feature Request issue with a subject of "New feature name".
- If no issue type is included in the subject line, but a default issue type is specified, then that issue type will be used. If only one issue type in the project is marked as accepting email submissions, it will be used regardless of whether the name is included in the email subject line.
A few notes
- Emailed attachments will be included in the Squish issues/comments.
- If an email fails to generate an issue or comment for some reason, the sender will receive an email notification detailing why.
- Issue notifications and webhooks will be processed as normal for emailed issues and comments.
Commenting on issues
The same user and permission checking happens when emailing a comment to a Squish issue, to determine which user to post the comment as. The only difference is that, instead of posting the entire contents of the email into the comment, only the last reply is included. For instance, emailing the following into a Squish issue:
I think that's a great idea!
On 2/11/2015, Joe Smith wrote:
> What about a way to email comments into Squish?
> I think that would be the tops!
Would result in a comment containing only "I think that's a great idea!". Comments submitted via email are indicated by a small envelope icon next to the posters name: