Skip to content

Commit 891435b

Browse files
committed
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
1 parent 0e63980 commit 891435b

10 files changed

Lines changed: 17 additions & 42 deletions

File tree

src/content/docs/email-service/concepts/deliverability.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,15 +35,15 @@ Soft bounces are temporary failures that may succeed if retried:
3535
- Email server temporarily down
3636
- Rate limiting or greylisting
3737

38-
Cloudflare automatically retries soft bounces with exponential backoff (15min → 1hr → 4hr → 12hr → 24hr) for up to 72 hours.
38+
Cloudflare automatically retries soft bounces with exponential backoff over an extended period.
3939

4040
<Sandboxing />
4141

4242
## Reputation management
4343

4444
Cloudflare automatically manages:
4545

46-
- **IP reputation**: Shared pools with tiered promotion based on sending quality
46+
- **IP reputation**: Managed sending infrastructure optimized for deliverability
4747
- **Domain authentication**: DKIM signing, SPF alignment, DMARC compliance
4848
- **Feedback processing**: ISP complaint handling and suppression list management
4949

src/content/docs/email-service/concepts/email-lifecycle.mdx

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ flowchart LR
2020
A[Request Received] --> B[Rate Limit Check] --> C[Authentication & Reputation] --> D[Suppression Check] --> E[Delivery Attempt]
2121
E --> G{Success?}
2222
G -->|Yes| F[Final Status & Metrics]
23-
G -->|No - Soft Bounce| H[Retry with Exponential Backoff<br/>Up to 3 attempts]
23+
G -->|No - Soft Bounce| H[Retry with Exponential Backoff]
2424
G -->|No - Hard Bounce| F
2525
H --> E
2626
H -->|Max retries exceeded| F
@@ -42,7 +42,7 @@ flowchart LR
4242
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.
4343

4444
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
4646
- **Hard bounces (5xx responses)**: The system marks the email as permanently failed with no retry attempts
4747

4848
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
5353
7. **Final status and metrics:** Based on the server response, the system assigns emails one of these final statuses:
5454
- **Delivered**: The email was successfully accepted by the recipient server
5555
- **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-
5856
---
5957

6058
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.

src/content/docs/email-service/concepts/suppressions.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ You may also manually add or remove email addresses from your suppression list a
4646
Cloudflare automatically suppresses addresses that:
4747

4848
- **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.
5050
- **Spam complaints**: Recipients who mark emails as spam are added to your account suppression list.
5151

5252
## Best practices

src/content/docs/email-service/configuration/domains.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Domain configuration (work in progress)
2+
title: Domain configuration
33
pcx_content_type: concept
44
summary: |
55
Configure domains for Cloudflare Email Service, manage DNS records, and verify domain setup for both email sending and routing.

src/content/docs/email-service/local-development/sending.mdx

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10,13 +10,6 @@ import { WranglerConfig } from "~/components";
1010

1111
Test email sending functionality locally using `wrangler dev` to simulate email delivery and verify your sending logic before deploying.
1212

13-
14-
::: Note
15-
16-
Local development is **not available** at this time.
17-
18-
:::
19-
2013
## Prerequisites
2114

2215
- [Wrangler CLI](https://developers.cloudflare.com/workers/wrangler/install-and-update/) installed

src/content/docs/email-service/observability/logs.mdx

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,6 @@ For outbound emails sent through Email Service:
1919
- **Sent**: Email successfully accepted and queued for delivery
2020
- **Delivered**: Email successfully delivered to recipient's mail server
2121
- **Bounced**: Email bounced (hard or soft bounce)
22-
- **Quarantined**: Email held for review due to reputation or content analysis
2322
- **Failed**: Email failed to send due to configuration or authentication issues
2423

2524
### Email routing logs
@@ -104,16 +103,14 @@ Use the Activity Log filters to find specific emails:
104103

105104
- Authentication failure rates
106105
- Bounce patterns and trends
107-
- Quarantine frequency
108106
- Delivery success rates
109107

110108
### Troubleshooting workflow
111109

112110
1. **Identify the issue**: Use logs to pinpoint failure types
113111
2. **Check authentication**: Verify SPF, DKIM, DMARC configuration
114-
3. **Review content**: Look for patterns in quarantined emails
115-
4. **Adjust configuration**: Make necessary DNS or routing changes
116-
5. **Monitor improvement**: Track metrics after changes
112+
3. **Adjust configuration**: Make necessary DNS or routing changes
113+
4. **Monitor improvement**: Track metrics after changes
117114

118115
---
119116

src/content/docs/email-service/observability/metrics-analytics.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
pcx_content_type: concept
3-
title: Metrics and analytics (work in progress)
3+
title: Metrics and analytics
44
sidebar:
55
order: 1
66
---

src/content/docs/email-service/platform/pricing.mdx

Lines changed: 6 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -11,18 +11,12 @@ Cloudflare Email Service pricing is based on your Cloudflare plan and email usag
1111

1212
Email Service is available on Free and Paid Cloudflare plans:
1313

14-
| | Free | Paid |
15-
| ------------------------------------------------------- | ---------------- | ------------------------------------------------------------ |
16-
| **Outbound emails (Email Sending)** | ❌ Not available | 10,000 emails included <br /> + $0.50 per 1,000 emails above |
17-
| **Outbound emails to Account-owned verified addresses** | ✅ Unlimited | ✅ Unlimited |
18-
| **Inbound emails (Email Routing)** | ✅ Unlimited | ✅ Unlimited |
14+
| | Free | Paid |
15+
| ------------------------------------------------------- | ---------------- | ---------------- |
16+
| **Outbound emails (Email Sending)** | ❌ Not available | ✅ Available |
17+
| **Outbound emails to Account-owned verified addresses** | ✅ Unlimited | ✅ Unlimited |
18+
| **Inbound emails (Email Routing)** | ✅ Unlimited | ✅ Unlimited |
1919

2020
Email Routing Workers is billed according to [Workers pricing](/workers/platform/pricing/).
2121

22-
### Volume discounts
23-
24-
Volume discounts available for high-volume senders. Contact sales for custom pricing on large volumes.
25-
26-
:::note[Volume Discount Application]
27-
Volume discounts apply only to overage emails, not included quotas.
28-
:::
22+
For details on Email Sending pricing, refer to the [Cloudflare dashboard](https://dash.cloudflare.com/).

src/content/docs/email-service/reference/postmaster.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
pcx_content_type: reference
3-
title: Postmaster (work in progress)
3+
title: Postmaster
44
sidebar:
55
order: 1
66
head: []
Lines changed: 1 addition & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,8 @@
11
## Sandboxing system
22

3-
:::note
4-
5-
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-
93
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.
115

126
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.
147

158
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

Comments
 (0)