emailmarketing.net

Yahoo Complaint Feedback Loop (CFL)

How Yahoo's DKIM-domain-based Complaint Feedback Loop works: enrollment via Sender Hub, ARF report format, and operational rules.

Operational3 min read

Who it is for Senders, ESP operators

Applies to senders on any platform

If you send mail to Yahoo users, you can receive a report each time one of them marks your message as spam. Yahoo's Complaint Feedback Loop (CFL) sends these reports in ARF (Abuse Reporting Format).

The reports let you suppress complainers from further campaigns and adjust your targeting and frequency. This matters because spam votes directly damage sender reputation, and count toward Yahoo's 0.3% complaint threshold (see Yahoo Sender Requirements).

Key properties

Property Value
Basis Domain-based, DKIM only. Only mail signed with DKIM is supported, because DKIM is how Yahoo identifies the sender actually responsible
IP-based FBL Not offered. Yahoo no longer supports CFL reporting based on IP addresses or CIDR ranges
Report format ARF
Coverage All consumer domains hosted by Yahoo, including AOL (thousands of hosted domains)
Who should enroll Bulk email senders. ESPs usually enroll DKIM domains on behalf of their clients

Enrollment (via Sender Hub)

  1. Create your Sender profile on Yahoo Sender Hub (senders.yahooinc.com).
  2. Add and verify your domains: the DKIM d= domains you sign with.
  3. Enroll each domain in the CFL.

Notes:

  • Enrollments made through Yahoo's old form, from before Sender Hub, did not carry over. You had to enroll again through Sender Hub. ARF reports for old enrollments stopped on August 1, 2024, with no grace period.
  • The reporting address can be any email address you control. Ownership is verified during enrollment, and you can reuse the same verified address to enroll more domains.
  • Enrolling the organizational domain does not enroll all its subdomains. ARF reports are sent for the enrolled DKIM domains that match the signature on the message that received the complaint. Enroll each signing domain.
  • To check the status of enrollments, edit them or delete them, go to Manage Services, then Complaint Feedback Loop, in your Sender Hub profile.

Report mechanics

  • All reports use the Abuse Reporting Format (ARF) and contain at least three MIME parts: a plain-text part, machine-readable metadata in MIME format, and the headers of the original message.
  • Report messages arrive with:
    • From header display name: "Yahoo! Mail AntiSpam Feedback"
    • SMTP sender: feedback@arf.mail.yahoo.com
    • A DKIM signature with the domain arf.mail.yahoo.com (verify the signature before you trust the reports or automate actions on them)
  • When a message has several DKIM signatures, Yahoo evaluates all of them for the CFL (and also for DMARC alignment and reputation).

Operational use

  • Automate suppression. Parse incoming ARF reports, and immediately unsubscribe or suppress the recipient who complained. Continuing to mail people who complained adds to the reputation damage.
  • Monitor the complaint rate. Comparing CFL volume with the volume delivered to Yahoo is the practical way to track your position against the 0.3% threshold. The complaints metric in the Performance Feeds gives an aggregate view.
  • Diagnose segments. A spike in ARF reports after a change in content, frequency or audience identifies the campaign or segment at fault.

Check your own record

The free check reads what your domain publishes in DNS.

In this topic

All 15 in Mailbox Providers →