Status
colour Green title Since version 8.0.0

The Incoming Mail Queue provides ways to look into the internal status of the mailbox connections. You can access the Incoming Mail Queue from the app's administration page.

The Incoming Mail Queue is related to Email This Issue's internal mailbox mail account connections, it does not show details of the Jira Mail Services (connections configured in Jira's Incoming Mail page).

Different Views in the Queue

The Incoming Mail Queue has different views related to the phases of an email being processed:

New Emails

This page lists the The New Emails queue displays all emails that were downloaded from all one of the enabled mail accounts. Emails are marked with the status: 

Status
colour Blue title New

 emails with status  are are downloaded successfully but not yet pssed passed to the mail handlers. Email this issue stores downloaded emails in the database before it passes them to the mail handlers.

Filtered Emails

This page lists the The Filtered Out queue displays all emails that were downloaded and passed to the mail handlers (attached to the mail account which downloaded the emailaccounts), but all of these handlers have refused to process the email. Details of the reason (why the email was has been filtered our) can be seen in the Incoming Mail Log.

Emails that are marked with the status:

Status
subtle true colour Blue title filtered

 emails remain on in the queue permanently and may be pushed back to the 

Status
colour Blue title New

 status. This makes it possible to attempt to process them again. Alternatively the emails may be removed from the queueif they are not removed.

Emails Being Processed

This page lists the The Being Processed queue displays emails that were downloaded and there was from one of the mail accounts and a handler that accepted it them for processing and the emails (they are being processed).

Normally processing Processing an email usually does not take long. It , however, it highly depends on the configuration of the mail handler but . Processing an email should not take more than 1-2 seconds in a well-performing system.

If Once the email was is successfully processed, it is removed from the queue and also from the database which keeps in order to keep the DB as reduced small as possible.

However, if If an error occurs duding while processing during the process, the email , it is moved to the Error Queue Failed queue.

Failed Emails

This is an error queue for emails which The Failed queue displays emails that the handlers could not successfully processedprocess. Error  Error details can be seen found in the Incoming Mail Log.

Emails that are marked with the status:

Status
colour Red title failed

 emails remain on in the queue permanently and may be pushed back to the 

Status
colour Blue title New

 status. This makes it possible to attempt to process them again. Alternatively the emails may be removed from the queueif they are not removed.

Email Details in the Queue

In all views, the queue shows the below detail details of the email items:

• Account: the incoming mail account which downloaded the email
• From: the sender of the email (email address and in some cases name as well)
• Subject: the subject of the email 
• Received: date and time of when the email was downloaded
• Processed: date and time of when the email was last submitted for processing by the handlers.

To reveal more details, click the > icon:

• To, Cc: recipients of the email
• Body: mail body in text format
• Message Headers: all headers hidden in the email

Remove

Removing Emails from the Incoming Mail Queue

Anchor

Filtered emails and those which failed to process will remain on

removing emails removing emails

Emails of the Filtered Out and Failed queues remain in the queue permanently. This is poses a kind risk of risk to increase increasing the size of the database dramatically.

To prevent this you can remove emails from the Filtered and Failed views in three these queues in one of the following ways:

• manually remove a single email
• manually remove multiple emails that are over a certain age
• schedule an automatic purge process to bulk remove items that are over a certain age
• manually remove multiple emails that are over a certain age

Delete a Single Email from the Queue

Anchor
manual single manual single

You can use the Delete menu of an email button to remove it a single email from the a queue: 

Manual Purge

Anchor
manual bulk manual bulk

To remove multiple items manually, click on the "Configure Purge" button in the page. This opens a form where the relevant field is Items to remove. This allows you to select the age of the mail items to remove. Options include emails older than 1 month, 3 months, 6 months.:

Image Added

To actually remove the mail items, click the Purge Items Permanently button.

Note
Do not click on Save Settings if you do not want to schedule an automatic purge.

Automatic Purge

Anchor
auto bulk auto bulk

To remove items automatically, click on the "Configure Purge" button in the page.

This opens a form where there are two relevant fields to set are:

• Hours Hour to start at: specifies when the purge job is started carried out every day

• Items to remove:   field allows you to select the age of the mail items to remove. Options include emails older than 1 month, 3 months, 6 months.

To schedule the job, click Save Settings.