Section 03 · 10 guides

ads.txt for AdSense: Syntax, Hosting, Errors and sellers.json

ads.txt is a one-line text file that decides whether buyers trust your inventory. These guides follow the IAB Tech Lab specification line by line, then cover the hosting traps (redirects, subdomains, CDNs) behind most "earnings at risk" warnings.

ads.txt & sellers.json
Image: Source code,Micke,CC BY-SA 3.0,via Wikimedia Commons.

All guides in this section (10)

  1. ads.txt syntax for AdSense, line by line: pub ID, DIRECT, TAG ID, comments and variables

    The AdSense ads.txt record is google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0, where pub-0000000000000000 is replaced by your own publisher ID.

  2. How to fix the AdSense "Earnings at risk" ads.txt alert

    The AdSense ads.txt alert appears when Google's crawler finds no ads.txt file on a site ("Not found") or finds one that does not include your publisher ID ("Unauthorized").

  3. ads.txt "Not found" or "Unauthorized": a technical checklist for redirects, HTTPS, status codes and robots.txt

    Google starts ads.txt crawling at the root domain: a file at www.domain.com/ads.txt is only crawled if domain.com/ads.txt redirects to it.

  4. ads.txt and subdomains: which file the crawler reads and when to use subdomain=

    Under the IAB ads.txt specification, crawlers fetch ads.txt from the root domain, defined as the public suffix plus one label, and strip subdomains from the URLs they crawl.

  5. Deploying ads.txt on static hosts and CDNs: public folders, redirects, headers and caching

    On static hosts, ads.txt belongs in the framework folder that is copied unchanged to the build output: public/ in Astro and Next.js, static/ in Hugo, a passthrough copy in Eleventy.

  6. How to add ads.txt to WordPress without a plugin (and avoid conflicts with virtual ads.txt files)

    On a self-hosted WordPress site, a physical ads.txt file uploaded to the web root is served directly by Apache or Nginx, before WordPress runs.

  7. Google's sellers.json for AdSense publishers: seller information visibility and what buyers see

    sellers.json is an IAB Tech Lab standard: each advertising system publishes a public JSON file listing the sellers it pays, so buyers can identify who is behind a seller ID declared in ads.txt.

  8. OWNERDOMAIN and MANAGERDOMAIN in ads.txt 1.1: syntax, when to add them, and sellers.json consistency

    OWNERDOMAIN and MANAGERDOMAIN are variables added to the IAB Tech Lab ads.txt specification in version 1.1, released in 2022.

  9. app-ads.txt vs ads.txt: the developer website, store listings and how verifiers find the file

    ads.txt authorizes sellers of website inventory and lives at the root of the site's domain; app-ads.txt authorizes sellers of app inventory and lives on the developer website listed in the app store.

  10. Validating ads.txt yourself: curl checks, the IAB Tech Lab open-source crawler and scripted audits

    AdSense's own status in the Sites page is the authoritative check for your account; self-validation tells you whether the file is reachable and correctly formed before Google recrawls.