Practical workflows for building and managing email newsletters for journalism and academia.
\n## Newsletter strategy document\n\n### Core identity\n- **Name**:\n- **Tagline** (one line):\n- **What readers get**: [specific value proposition]\n- **Frequency**: [ ] Daily [ ] Weekly [ ] Bi-weekly [ ] Monthly\n\n### Target audience\n- Primary reader:\n- What they care about:\n- Why they'll subscribe:\n- What they'll do with this info:\n\n### Content pillars\n1. [Core topic 1] - [how often]\n2. [Core topic 2] - [how often]\n3. [Recurring feature] - [how often]\n\n### Voice and tone\n- Formal ↔ Conversational: [1-5]\n- Serious ↔ Light: [1-5]\n- Reported ↔ Personal: [1-5]\n\n### Success metrics (first 6 months)\n- Subscriber goal:\n- Target open rate:\n- Target click rate:\n## [Newsletter Name] - Issue #[XX]\n**Date**: [Date]\n**Subject line**: [Subject]\n**Preview text**: [First 50-90 characters readers see]\n\n---\n\n### Opening hook\n[2-3 sentences that make readers want to keep reading]\n\n### Main story\n[Your primary content - 300-600 words for most newsletters]\n\n### Secondary items (if applicable)\n- **Quick hit 1**: [Brief item with link]\n- **Quick hit 2**: [Brief item with link]\n\n### Recurring section\n[Weekly column, data point, recommendation, etc.]\n\n### Sign-off\n[Personal note, call to action, or preview of next issue]\n\n---\n\n**Unsubscribe** | **Preferences** | **Forward to a friend**\n<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n <title>{{newsletter_name}}</title>\n <style>\n /* Reset styles for email clients */\n body { margin: 0; padding: 0; width: 100%; }\n table { border-collapse: collapse; }\n img { border: 0; display: block; }\n\n /* Responsive container */\n .container {\n max-width: 600px;\n margin: 0 auto;\n font-family: Georgia, serif;\n font-size: 18px;\n line-height: 1.6;\n color: #333;\n }\n\n /* Dark mode support */\n @media (prefers-color-scheme: dark) {\n .container { background-color: #1a1a1a; color: #e0e0e0; }\n a { color: #6db3f2; }\n }\n\n /* Mobile styles */\n @media only screen and (max-width: 480px) {\n .container { padding: 15px !important; }\n h1 { font-size: 24px !important; }\n }\n </style>\n</head>\n<body>\n <table role=\"presentation\" width=\"100%\">\n <tr>\n <td align=\"center\" style=\"padding: 20px;\">\n <div class=\"container\">\n <!-- Header -->\n <table width=\"100%\">\n <tr>\n <td style=\"padding-bottom: 20px; border-bottom: 2px solid #333;\">\n <h1 style=\"margin: 0;\">{{newsletter_name}}</h1>\n <p style=\"margin: 5px 0 0; color: #666;\">{{issue_date}}</p>\n </td>\n </tr>\n </table>\n\n <!-- Content -->\n <table width=\"100%\">\n <tr>\n <td style=\"padding: 30px 0;\">\n {{content}}\n </td>\n </tr>\n </table>\n\n <!-- Footer -->\n <table width=\"100%\">\n <tr>\n <td style=\"padding-top: 20px; border-top: 1px solid #ddd; font-size: 14px; color: #666;\">\n <p>You're receiving this because you subscribed to {{newsletter_name}}.</p>\n <p>\n <a href=\"{{unsubscribe_url}}\">Unsubscribe</a> |\n <a href=\"{{preferences_url}}\">Update preferences</a>\n </p>\n </td>\n </tr>\n </table>\n </div>\n </td>\n </tr>\n </table>\n</body>\n</html>\nfrom dataclasses import dataclass, field\nfrom datetime import datetime\nfrom typing import List, Dict, Optional\nfrom enum import Enum\nimport hashlib\n\nclass SubscriberStatus(Enum):\n ACTIVE = \"active\"\n UNSUBSCRIBED = \"unsubscribed\"\n BOUNCED = \"bounced\"\n COMPLAINED = \"complained\"\n\n@dataclass\nclass Subscriber:\n email: str\n name: Optional[str] = None\n subscribed_at: datetime = field(default_factory=datetime.now)\n status: SubscriberStatus = SubscriberStatus.ACTIVE\n tags: List[str] = field(default_factory=list)\n custom_fields: Dict = field(default_factory=dict)\n\n @property\n def hash_id(self) -> str:\n \"\"\"Generate unique ID for unsubscribe links.\"\"\"\n return hashlib.md5(self.email.encode()).hexdigest()[:12]\n\n@dataclass\nclass NewsletterIssue:\n subject: str\n preview_text: str\n html_content: str\n plain_text: str\n scheduled_at: Optional[datetime] = None\n sent_at: Optional[datetime] = None\n issue_number: int = 0\n\n # Metrics\n sent_count: int = 0\n delivered_count: int = 0\n opened_count: int = 0\n clicked_count: int = 0\n bounced_count: int = 0\n unsubscribed_count: int = 0\n\n @property\n def open_rate(self) -> float:\n if self.delivered_count == 0:\n return 0.0\n return (self.opened_count / self.delivered_count) * 100\n\n @property\n def click_rate(self) -> float:\n if self.delivered_count == 0:\n return 0.0\n return (self.clicked_count / self.delivered_count) * 100\n\nclass NewsletterManager:\n \"\"\"Core newsletter operations.\"\"\"\n\n def __init__(self, name: str):\n self.name = name\n self.subscribers: List[Subscriber] = []\n self.issues: List[NewsletterIssue] = []\n\n def add_subscriber(self, email: str, name: str = None,\n tags: List[str] = None) -> Subscriber:\n \"\"\"Add new subscriber with double opt-in pending.\"\"\"\n sub = Subscriber(\n email=email.lower().strip(),\n name=name,\n tags=tags or []\n )\n self.subscribers.append(sub)\n return sub\n\n def segment_subscribers(self, tags: List[str] = None,\n min_engagement: float = None) -> List[Subscriber]:\n \"\"\"Get subscribers matching criteria.\"\"\"\n active = [s for s in self.subscribers\n if s.status == SubscriberStatus.ACTIVE]\n\n if tags:\n active = [s for s in active\n if any(t in s.tags for t in tags)]\n\n return active\n\n def calculate_engagement_score(self, subscriber: Subscriber) -> float:\n \"\"\"Score subscriber engagement 0-100.\"\"\"\n # Implementation would track opens/clicks per subscriber\n return 50.0 # Placeholder\nfrom datetime import datetime, timedelta\n\ndef clean_subscriber_list(manager: NewsletterManager,\n inactive_threshold_days: int = 180) -> dict:\n \"\"\"Identify and handle inactive subscribers.\"\"\"\n cutoff = datetime.now() - timedelta(days=inactive_threshold_days)\n\n results = {\n 'total': len(manager.subscribers),\n 'active': 0,\n 'inactive': [],\n 'bounced': [],\n 'unsubscribed': []\n }\n\n for sub in manager.subscribers:\n if sub.status == SubscriberStatus.BOUNCED:\n results['bounced'].append(sub.email)\n elif sub.status == SubscriberStatus.UNSUBSCRIBED:\n results['unsubscribed'].append(sub.email)\n elif sub.status == SubscriberStatus.ACTIVE:\n # Check last engagement\n engagement = manager.calculate_engagement_score(sub)\n if engagement < 10: # Very low engagement\n results['inactive'].append(sub.email)\n else:\n results['active'] += 1\n\n return results\n\ndef run_reengagement_campaign(inactive_subscribers: List[str]) -> None:\n \"\"\"Send win-back campaign to inactive subscribers.\"\"\"\n # Send \"We miss you\" campaign\n # If no engagement after 2 attempts, mark for removal\n pass\n## Recommended segments\n\n### By engagement\n- **VIPs**: Open rate > 80%, always click\n- **Engaged**: Open rate 40-80%\n- **Casual**: Open rate 10-40%\n- **At-risk**: Haven't opened in 90 days\n- **Inactive**: Haven't opened in 180 days\n\n### By interest (tag-based)\n- Topic preferences from signup\n- Content they've clicked\n- Surveys/polls they've answered\n\n### By source\n- Organic (website signup)\n- Referral (forwarded by friend)\n- Social media\n- Paywall/registration wall\n## Subject line formulas that work\n\n### For news/journalism\n- **Breaking format**: \"Breaking: [Concise news]\"\n- **Numbers**: \"[X] things we learned about [topic]\"\n- **Question**: \"Why did [entity] do [thing]?\"\n- **Direct**: \"[Topic]: What you need to know\"\n\n### For analysis/opinion\n- **Take**: \"The real story behind [event]\"\n- **Contrarian**: \"Why everyone is wrong about [topic]\"\n- **Insider**: \"What [industry] insiders know about [topic]\"\n\n### What to avoid\n- ALL CAPS\n- Excessive punctuation!!!\n- Clickbait that doesn't deliver\n- Spam trigger words (FREE, URGENT, ACT NOW)\n- Misleading preview text\nimport random\nfrom typing import List, Tuple\n\ndef ab_test_subject_lines(subscribers: List[Subscriber],\n subject_a: str,\n subject_b: str,\n test_percentage: float = 0.2) -> dict:\n \"\"\"\n Test two subject lines on subset before full send.\n \"\"\"\n test_size = int(len(subscribers) * test_percentage)\n test_group = random.sample(subscribers, test_size)\n\n # Split test group\n half = len(test_group) // 2\n group_a = test_group[:half]\n group_b = test_group[half:]\n\n remaining = [s for s in subscribers if s not in test_group]\n\n return {\n 'group_a': {\n 'subject': subject_a,\n 'subscribers': group_a,\n 'size': len(group_a)\n },\n 'group_b': {\n 'subject': subject_b,\n 'subscribers': group_b,\n 'size': len(group_b)\n },\n 'remaining': {\n 'subscribers': remaining,\n 'size': len(remaining),\n 'note': 'Send winner to this group after test period'\n },\n 'test_duration_hours': 4\n }\n## DNS records for deliverability\n\n### SPF record\nv=spf1 include:_spf.{{esp_sending_domain}} ~all
\n\n### DKIM\n- Generate keys through your ESP\n- Add TXT record with public key\n- Verify signature is applied to outgoing mail\n\n### DMARC\nv=DMARC1; p=quarantine; rua=mailto:dmarc@yourdomain.com
\n\n### Checklist before sending\n- [ ] SPF, DKIM, DMARC configured\n- [ ] Sending domain warmed up\n- [ ] List is clean (no hard bounces)\n- [ ] Unsubscribe link works\n- [ ] Physical address in footer (CAN-SPAM)\n- [ ] Test email received in inbox (not spam)\nBulk senders must meet authentication and unsubscribe requirements introduced by Gmail and Yahoo in February 2024. Microsoft Outlook adopted a parallel set in May 2025. Since November 2025, Gmail rejects non-compliant mail with permanent 5xx errors rather than soft-deferring it, non-compliant newsletters now bounce hard.
\nWho is covered. A \"bulk sender\" is one mailing more than 5,000 messages per day to Gmail addresses. The 5,000 threshold is counted at the primary domain level across all subdomains, not per sending subdomain. A newsroom sending 2,500/day from transactional.example.com and 2,500/day from news.example.com is over the threshold.
Required:
\np=none. Production senders should move to p=quarantine or p=reject once aligned.From: header, not both. Relaxed alignment is acceptable.List-Unsubscribe header with an HTTPS URL and a List-Unsubscribe-Post: List-Unsubscribe=One-Click header. The HTTPS endpoint must process the unsubscribe within two days without requiring login. A visible unsubscribe link must also appear in the message body.Operational implications:
\nMost reputable ESPs handle authentication, headers, and TLS once the sending domain is verified. The two parts that remain the operator's responsibility are complaint rate and unsubscribe behavior, re-engagement campaigns and prompt list hygiene matter here. Re-engaging dormant subscribers is risky precisely because they complain at 5–10× the rate of active ones; one bad re-engagement campaign can push complaint rate over 0.3 percent and trigger rejections across the entire sending domain.
\nReferences:
\nsupport.google.com/mail/answer/81126support.google.com/a/answer/14229414senders.yahooinc.com/best-practices/## Before you send\n\n### Content checks\n- [ ] No spam trigger words\n- [ ] Text-to-image ratio good (mostly text)\n- [ ] All links are to reputable domains\n- [ ] No URL shorteners (use full links)\n- [ ] Plain text version included\n\n### Technical checks\n- [ ] From address matches sending domain\n- [ ] Reply-to address is monitored\n- [ ] Preheader text is set\n- [ ] Images have alt text\n- [ ] Links are not broken\nfrom dataclasses import dataclass\n\n@dataclass\nclass NewsletterAnalytics:\n \"\"\"Track newsletter performance over time.\"\"\"\n\n issue: NewsletterIssue\n\n def summary(self) -> dict:\n return {\n 'issue_number': self.issue.issue_number,\n 'sent': self.issue.sent_count,\n 'delivered': self.issue.delivered_count,\n 'delivery_rate': self._pct(self.issue.delivered_count,\n self.issue.sent_count),\n 'opens': self.issue.opened_count,\n 'open_rate': self.issue.open_rate,\n 'clicks': self.issue.clicked_count,\n 'click_rate': self.issue.click_rate,\n 'click_to_open': self._pct(self.issue.clicked_count,\n self.issue.opened_count),\n 'unsubscribes': self.issue.unsubscribed_count,\n 'unsubscribe_rate': self._pct(self.issue.unsubscribed_count,\n self.issue.delivered_count),\n }\n\n def _pct(self, numerator: int, denominator: int) -> float:\n if denominator == 0:\n return 0.0\n return round((numerator / denominator) * 100, 2)\n\n# Benchmarks (journalism newsletters)\nBENCHMARKS = {\n 'open_rate': {'good': 40, 'excellent': 55},\n 'click_rate': {'good': 4, 'excellent': 8},\n 'unsubscribe_rate': {'acceptable': 0.5, 'concerning': 1.0},\n}\n| Platform | \nBest for | \nPricing model | \nKey feature | \n
|---|---|---|---|
| Substack | \nWriter-first, paid subs | \nRevenue share | \nBuilt-in payments | \n
| Buttondown | \nDevelopers, minimal | \nPer subscriber | \nMarkdown native | \n
| Ghost | \nPublishers, memberships | \nFlat fee | \nFull CMS included | \n
| beehiiv | \nGrowth-focused | \nFreemium | \nReferral tools | \n
| Kit (formerly ConvertKit) | \nCreators | \nPer subscriber | \nAutomation | \n
| Mailchimp | \nSmall orgs | \nTiered | \nEasy templates | \n
- [ ] Accurate \"From\" name and email\n- [ ] Non-deceptive subject line\n- [ ] Physical postal address included\n- [ ] Working unsubscribe mechanism\n- [ ] Unsubscribe honored within 10 days\n- [ ] No purchased lists\n- [ ] Explicit consent obtained (not pre-checked)\n- [ ] Clear privacy policy linked\n- [ ] Easy unsubscribe process\n- [ ] Data export available on request\n- [ ] Data deletion on request\n- [ ] Record of consent stored\n| Field | \nValue | \n
|---|---|
| version | \n1.0.0 | \n
| created | \n2025-12-26 | \n
| updated | \n2026-05-08 | \n
| author | \nJoe Amditis | \n
| domain | \npublishing, marketing | \n
| complexity | \nintermediate | \n