Skip to content

Commit a47fcdc

Browse files
committed
clarify difference between failover and round-robin mail transports
1 parent 771ec78 commit a47fcdc

File tree

1 file changed

+7
-3
lines changed

1 file changed

+7
-3
lines changed

mailer.rst

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -210,7 +210,7 @@ A failover transport is configured with two or more transports and the
210210
211211
MAILER_DSN="failover(postmark+api://ID@default sendgrid+smtp://KEY@default)"
212212
213-
The mailer will start using the first transport and if it fails, it
213+
The failover-transport starts using the first transport and if it fails, it
214214
will retry the same delivery with the next transports until one of them succeeds
215215
(or until all of them fail).
216216

@@ -227,8 +227,12 @@ A round-robin transport is configured with two or more transports and the
227227
228228
MAILER_DSN="roundrobin(postmark+api://ID@default sendgrid+smtp://KEY@default)"
229229
230-
The round-robin transport is similar to the failover transport (see above), but
231-
it starts with a *randomly* selected transport instead of the first in the list.
230+
The round-robin transport starts with a *randomly* selected transport and
231+
then switches to the next available transport for each subsequent email.
232+
233+
As with the failover transport, round-robin retries deliveries until
234+
a transport succeeds (or all failed). In contrast to the failover transport,
235+
it *balances* the load between all its transports.
232236

233237
.. versionadded:: 5.1
234238

0 commit comments

Comments
 (0)