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.

A template with Odeslat hned (mimo frontu) (send immediately) on always goes straight to the recipient, in every mode — do not look for it in the queue. An invoice sent from the administration is one of them, see Emails.

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. The system does not retry it straight away but with a growing delay: after 1 minute, 5 minutes, 30 minutes, 2 hours and then after 24 hours. When the message uses up the Počet pokusů o odeslání (sending attempts; default 5, set in Settings), it is marked as stopped and no longer retried. At the same time an E-mail se nepodařilo doručit (email could not be delivered) notification with a link to the message appears in the bell — at most one per sending run, even when several messages failed.

A stopped message does not revive itself

Remove the cause, open the message and switch Zastaveno (stopped) off. The message gets one more attempt; if it fails again, it is stopped again at once.

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#

Sent and stopped messages older than Uchovat odeslané zprávy (dny) (keep sent messages; default 30 days, see Settings) are deleted once a day by a scheduled server job. Newsletters are left out.

Do not shorten the retention too much

Sent messages help when a customer says nothing arrived — you can see when, where and what was sent.

You will not find account passwords in the queue

The registration email contains no password, and in older registration messages it is replaced with the text "(odstraněno)" (removed). The exception is the email sent after posting an advert or company listing without signing in — that one carries the advert's management password. That is one more reason to let the queue clean itself up automatically.

Cookie settings