Woodpecker is a Polish cold outreach platform targeting agencies, SDRs, and lead generation teams that want fine-grained deliverability control on outbound campaigns. The unsubscribe mechanism uses a merge variable placed manually in the email body, and Woodpecker offers a native opt-out landing page hosted on their domain. Opt-outs sync across all campaigns in the workspace and can be exported to CRM via native HubSpot, Pipedrive, and Salesforce integrations. RFC 8058 compliance depends on the sending mailbox authentication. This guide covers the tag, the opt-out landing page config, and the CRM sync patterns.
Woodpecker unsubscribe link
| Tag syntax | {{UNSUBSCRIBE_URL}} |
| Placement | Manual placement in the email body |
| Scope | Workspace-wide opt-out with CRM sync |
| Config path | Settings > Domains > Manage opt-out page |
| RFC 8058 one-click | Depends on connected mailbox authentication |
How to add the unsubscribe tag in Woodpecker
Place the merge tag exactly as shown below in the email template. Woodpecker replaces it at send time with a signed URL scoped to the recipient and campaign.
{{UNSUBSCRIBE_URL}}For custom HTML templates, wrap the tag in an anchor to render a proper hyperlink in the delivered email:
<a href="{{UNSUBSCRIBE_URL}}">Unsubscribe from this list</a>Manual placement in the email body
Depends on connected mailbox authentication The recipient's mailbox provider (Gmail, Yahoo) uses the List-Unsubscribe-Post header to expose the native one-click button on the message. Requires domain authentication with DKIM and DMARC.
Woodpecker opt-out landing page defaults to a Woodpecker-branded confirmation. Custom-brand it via Settings > Custom Domains and CNAME your subdomain to the Woodpecker opt-out endpoint. Prospects double-click confirming to a Woodpecker.co URL creates trust issues in some enterprise buying processes.
Testing your Woodpecker unsubscribe link
- Send a test message to a controlled Gmail address you own via the Woodpecker campaign preview action
- Click the footer unsubscribe link and confirm the opt-out on the landing page
- Check the subscriber or contact record: the status should be Unsubscribed within seconds
- Verify the RFC 8058 headers in Gmail: open the message, click three dots, then Show original. Look for
List-UnsubscribeandList-Unsubscribe-Post: List-Unsubscribe=One-Click
Want the full 222-platform reference?
See the pillar guide with the compliance landscape, the RFC 8058 deep dive, and the unsubscribe tag for every ESP: How to add an unsubscribe link: the complete 2026 guide →
Woodpecker and cold email sequences
Woodpecker is a cold email platform focused on sales prospecting and lead generation for SMB and mid-market teams. Its unsubscribe mechanism uses the {{OPT_OUT}} merge variable, replaced with a signed URL at send time. Woodpecker sequence templates typically include the opt-out link in every message, satisfying CAN-SPAM requirements for US-directed prospecting. For 1:1 personalized replies outside sequences, the link is optional and matches the tone of legitimate sales conversation.
Reply detection and sequence exit
Woodpecker automatically detects genuine replies and exits prospects from active sequences, regardless of whether they clicked the opt-out link. This reduces the risk of continuing to send to someone who has already responded positively or negatively. Opt-out clicks add the prospect to the account-wide blocklist, preventing further sequence outreach across all campaigns in the Woodpecker account. Combined with reply detection, this gives sales teams a robust safety net against unwanted follow-ups.
RFC 8058 support
Woodpecker adds RFC 8058 one-click unsubscribe headers on sequence sends from connected mailboxes. Each mailbox (Gmail, Outlook, or custom SMTP) must have DKIM configured for headers to route correctly; Woodpecker onboarding includes DKIM verification. The List-Unsubscribe and List-Unsubscribe-Post headers satisfy the Gmail and Yahoo February 2024 bulk-sender requirements. Woodpecker also implements deliverability guardrails (warmup, throttling, reply-rate monitoring) that pause campaigns when metrics indicate problems.
CAN-SPAM and international compliance
US cold email under CAN-SPAM requires unsubscribe, physical address, and truthful From information. Woodpecker supports all three when configured correctly. For EU prospecting, GDPR generally requires prior consent; unsubscribe links do not create consent. Woodpecker does not gate sends by geography, so senders are responsible for their own compliance with local laws. Segmenting outreach by jurisdiction is standard practice for teams operating internationally.
About the Author
Alaa · LinkedIn
Email infrastructure specialist with 8+ years of hands-on experience in SMTP, deliverability, and email verification. I’ve configured and troubleshot mail systems across Postfix, Exchange, and cloud relays, managed IP reputation and warmup campaigns, and built verification pipelines processing millions of addresses. My work spans DNS authentication (SPF, DKIM, DMARC, BIMI), bounce handling, blocklist monitoring, and compliance frameworks including CAN-SPAM and GDPR. I write every article on SMTPedia to give email professionals, developers, and marketers the accurate, RFC-grounded reference they need.
About SMTPedia
SMTPedia is an independent email industry reference covering SMTP, IMAP, POP3, email deliverability, marketing platforms, DNS authentication, and email verification. Every article is researched from official provider documentation, IETF RFCs, and industry best practices. Settings and configurations are verified quarterly.
We are cited as a source by ChatGPT, Microsoft Copilot, and thousands of email professionals worldwide. Learn more about our editorial process.
