---
title: Documentation
url: "https://b13.com/products/mail-queue-for-typo3/documentation"
date: 2026-09-11
modified: 2026-09-25
lastUpdated: 2026-09-25
---

# Documentation

![Envelope icon with a circular arrow, indicating the action of replying to an email, set against a gradient background.](https://b13.com/fileadmin/_processed_/1/7/csm_sharing-ext-mail-queue-S_91a8e0ced6.webp)

 Documentation
===============

 TYPO3 Extension “Mail Queue”
 Version 1.7.0 (2026-09-12)

  Mail Queue keeps TYPO3's immediate mail delivery intact and catches what fails. In the normal case nothing sits between your request and SMTP. When delivery fails, the mail lands in a database queue and is retried with exponential backoff instead of being lost.

It hooks into TYPO3's mail transport rather than into application code, so it covers **every mail of the instance**: your own extensions, the form framework, felogin password resets. No calling code changes.

   Compatibility
---------------

TYPO3 v13.4 LTS (13.4.23 or later) and v14, PHP 8.2+. The 13.4.23 floor is not arbitrary: queued payloads are restored through the hardened `PolymorphicDeserializer` the core introduced in its January 2026 security release.

Release notes live in the [changelog](https://b13.com/products/mail-queue-for-typo3/changelog).

   Contents
----------

| Chapter | What It Covers |
|---|---|
| [Installation](https://b13.com/products/mail-queue-for-typo3/documentation/installation) | Setup, production checklist, smoke test |
| [How It Works](https://b13.com/products/mail-queue-for-typo3/documentation/how-it-works) | Delivery path, statuses, backoff, attachments |
| [Backend Module](https://b13.com/products/mail-queue-for-typo3/documentation/backend-module) | List, actions, access levels, per-tenant scoping |
| [Archive Mode](https://b13.com/products/mail-queue-for-typo3/documentation/archive-mode) | Keeping sent mails and re-sending them |
| [Force Hold](https://b13.com/products/mail-queue-for-typo3/documentation/force-hold-never-send-from-an-environment) | "This environment must never send mail" |
| [Multiple Transports](https://b13.com/products/mail-queue-for-typo3/documentation/multiple-transports-multi-tenant) | Multi-tenant routing per SMTP account |
| [Webhook Alerting](https://b13.com/products/mail-queue-for-typo3/documentation/webhook-alerting) | Alerts that survive a broken SMTP server |
| [Console Commands](https://b13.com/products/mail-queue-for-typo3/documentation/console-commands) | `flush`, `cleanup`, `purge`, `send-test` |
| [Configuration](https://b13.com/products/mail-queue-for-typo3/documentation/configuration) | Every setting and its default |

The [dashboard widget](https://b13.com/products/mail-queue-for-typo3/documentation/installation#c12487) is covered at the end of the installation chapter.

   Where to Start
----------------

**Setting it up for the first time?** Read [Installation](https://b13.com/products/mail-queue-for-typo3/documentation/installation) end to end, including the production checklist. Two items there are easy to miss and both cost mails.

**Running it already and something looks wrong?** [How It Works](https://b13.com/products/mail-queue-for-typo3/documentation/how-it-works) explains what each status means, and the [Backend Module](https://b13.com/products/mail-queue-for-typo3/documentation/backend-module) chapter covers what you can do about a stuck entry.

**Setting up a staging environment?** Go straight to [Force Hold](https://b13.com/products/mail-queue-for-typo3/documentation/force-hold-never-send-from-an-environment)—and mind the retention note there, or the queue table and payload directory grow without bound.

 Documentation