You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: remove internal details, pricing, quarantine refs, and WIP labels
- Remove all quarantine system references (email-lifecycle, logs)
- Remove '(work in progress)' from page titles (domains, metrics, postmaster)
- Remove internal timeline note and fix typo in sandboxing partial
- Generalize retry intervals and suppression thresholds (internal details)
- Reword IP reputation to not expose tiered pool architecture
- Remove specific pricing figures
- Remove 'not available' contradiction from local dev sending page
G -->|No - Soft Bounce| H[Retry with Exponential Backoff<br/>Up to 3 attempts]
23
+
G -->|No - Soft Bounce| H[Retry with Exponential Backoff]
24
24
G -->|No - Hard Bounce| F
25
25
H --> E
26
26
H -->|Max retries exceeded| F
@@ -42,7 +42,7 @@ flowchart LR
42
42
4.**Suppression list check:** The system checks the recipient against global suppression lists that include bounces, complaints, and unsubscribes. Recipients found on these lists are blocked from receiving the email.
43
43
44
44
5.**Delivery attempt:** The system connects to the recipient's mail server and attempts message delivery via SMTP. When delivery fails, the system applies different retry logic based on the failure type:
45
-
-**Soft bounces (4xx responses)**: The system retries delivery up to 3 times using exponential backoff timing
45
+
-**Soft bounces (4xx responses)**: The system retries delivery using exponential backoff timing
46
46
-**Hard bounces (5xx responses)**: The system marks the email as permanently failed with no retry attempts
47
47
48
48
6.**Server response handling:** The system processes SMTP response codes from the recipient server to determine the final email status:
@@ -53,8 +53,6 @@ flowchart LR
53
53
7.**Final status and metrics:** Based on the server response, the system assigns emails one of these final statuses:
54
54
-**Delivered**: The email was successfully accepted by the recipient server
55
55
-**Bounced**: The email permanently failed delivery (hard bounce) or exceeded the maximum retry attempts (soft bounce)
56
-
-**Quarantined**: The email is held for review due to content analysis or reputation concerns
57
-
58
56
---
59
57
60
58
Understanding the email lifecycle helps you build robust email applications that handle all possible outcomes and provide excellent user experiences through proper status tracking and error handling.
-**Hard bounce**: Invalid or non-existent email addresses are immediately added to the Cloudflare global suppression list.
49
-
-**Repeated soft bounces**: Addresses that fail delivery 3-5 times within a 48 hour period are temporarily suppressed. Emails that soft bounce more than 5 times are added to the global suppression list.
49
+
-**Repeated soft bounces**: Addresses that repeatedly fail delivery are temporarily or permanently suppressed based on the frequency and pattern of failures.
50
50
-**Spam complaints**: Recipients who mark emails as spam are added to your account suppression list.
The sandboxing system is not currently present in the Email Service public beta. It will be implemented by the release of the public beta.
6
-
7
-
:::
8
-
9
3
When you first onboard onto Email Service, you are given a **sandbox access**. **Sandbox access** only allows you to send emails to **verified emails** in your account.
10
-
This provides you with a sanboxed environment for testing and developing your application without affecting your domain's reputation.
4
+
This provides you with a sandboxed environment for testing and developing your application without affecting your domain's reputation.
11
5
12
6
When you are ready to move to production and send emails to any email address, you must fill out the **Production Access Form** to provide additional details about your planned usage.
13
-
The Cloudflare Email Service team will review your planned usage, as well as your historical usage of Workers or other Cloudflare products and other factors.
14
7
15
8
At this time, only transactional email use cases are permitted for use with Email Service and this will be verified during onboarding and during your usage of Email Service.
0 commit comments