Skip to content
A
For administrators
Running the administration — content, users, e-shop, invoicing and settings
System / E-mail queue

E-mail queue#

Messages waiting to be sent, and a record of those already sent. Find them under Systém → Fronta emailů.

Why the queue exists#

Messages are not sent at the moment of the action; they are put in a queue and sent in batches.

If they were sent immediately, the customer would wait

Sending an email takes seconds. An order that mails a confirmation to the customer and to you would take noticeably longer to complete. And if the mail server were down, the whole order would fail — this way only the message waits.

What a message shows#

Field Note
Subject and text what is being sent
Sent and sent at
Attempts how many times it was tried
Error why it failed
Stopped the message will not be retried
Attachments and reply-to
Priority sent ahead of the rest

Priority messages#

Some messages cannot wait — registration confirmation, a password reset. Those are priority and go ahead of bulk sending.

The newsletter is deliberately slow

Sending thousands of messages runs in the background for a long time so the provider does not judge it spam. Priority messages overtake it, so a registration does not have to wait.

Depending on the setting, priority messages may never reach the queue at all

The system has three sending modes: everything into the queue (the default), only non-priority into the queue — priority ones then go out immediately and you will not find them in the list — and everything immediately, where the queue is not used at all.

If you are looking for a password reset in the queue and it is not there, that need not be a fault

First check with your administrator which mode is on. Only then look into why the message was not stored.

Unsent messages#

A failed message shows its error and attempt count. After several failures the message is marked as stopped and no longer retried.

A stopped message does not revive itself

Remove the cause and start the message again. Otherwise it simply sits there.

The most common causes:

Error What to do
Login rejected wrong password or user in the SMTP settings
Recipient does not exist a typo in the email; the customer's mistake
Rejected by the recipient's server a full mailbox, or they consider you spam
Timeout the mail server did not respond; try again

🔴 When nothing arrives at all#

A queue that is not sending means stalled orders and registrations

Messages pile up, nobody gets a confirmation, and customers assume their order did not go through. Check it as soon as unsent messages start accumulating.

Steps:

  1. How many are unsent, and since when?
  2. Do they show an error, or were they never attempted?
  3. No error and no attempts → the scheduled task is not running. Dispatch should run every minute, so a message older than a few minutes with not a single attempt is a clear symptom. Contact your administrator.
  4. With an error → read it; it is usually unambiguous.

Housekeeping#

Keep sent messages for a few weeks

They help when a customer says nothing arrived — you can see when, where and what was sent. Older ones can be deleted, which speeds the queue up.