Get started →

Home / Guides / ads.txt for publishers: the format, the mistakes and the fixes

● Ad Manager

ads.txt for publishers: the format, the mistakes and the fixes

Updated 16 November 2026 · 3 min read · By Arslan Mehdi

ads.txt is a small text file with a big job. It tells buyers which companies are allowed to sell ads on your site. If it's missing or wrong, a lot of demand will simply not bid. Here's how it works and how to keep it right.

What ads.txt is

ads.txt stands for "Authorized Digital Sellers". It's an IAB Tech Lab standard. You publish a plain text file at the root of your domain, listing every company and account allowed to sell your inventory. Buyers crawl it and compare it against the seller in each bid request. If the seller isn't listed, many buyers won't spend.

The file lives at exactly one place:

https://yoursite.com/ads.txt

How a line is built

Each line has three required fields and one optional field, separated by commas:

google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0
FieldExampleMeaning
Ad system domaingoogle.comThe platform selling the ad.
Account IDpub-0000…The seller's account on that platform.
RelationshipDIRECT / RESELLERDIRECT if the account owner controls the account; RESELLER if someone sells on your behalf.
Certification IDf08c47fec0942fa0Optional ID for the ad system, from the Trustworthy Accountability Group.

The account ID above is a placeholder. Use the real lines your partners give you.

ads.txt in an MCM setup

When you join a partner through MCM, they give you the lines to add. Those usually include your partner's Google account and the lines for any header-bidding partners they bring. Copy them exactly as supplied, including the relationship field. Your partner knows which value applies to your delegation type; don't change it to "look right".

If you use more than one partner, keep every partner's lines. ads.txt is a list, not a choice.

The mistakes we see most

  • Wrong location. The file must be at the root of the domain, not in a folder or a CMS page.
  • Served as HTML. Some CMSs wrap the file in a page template. Open it in a browser: you should see plain text, nothing else.
  • Typos in account IDs. One wrong digit and the line is useless.
  • Smart quotes or odd characters. Copying from a word processor can add them. Edit in a plain text editor.
  • Redirects that drop the file. If yoursite.com redirects to www.yoursite.com, make sure the file is reachable after the redirect.
  • Old lines left behind. Lines for partners you left still let someone sell your name. Remove them.

Subdomains and apps

ads.txt is read from the root domain. If you sell ads on a subdomain, the standard lets the root file point to it with a subdomain= line, and the subdomain can host its own file. For mobile apps there's a sister standard, app-ads.txt, hosted on the developer website listed in the app store.

Keeping it tidy over time

ads.txt isn't a set-and-forget file. It drifts. Partners add demand sources and send you new lines; you stop working with someone and forget to remove theirs; a site migration quietly drops the file. A short routine stops most of that.

  • Keep a master copy. Store the current file somewhere outside your CMS, with a note of which partner each block of lines belongs to. Comments starting with # are allowed in ads.txt and are a good way to label blocks.
  • Review it monthly. Open the live file and compare it with your master copy. It takes two minutes.
  • Check after every migration. New hosting, a new CMS or a new CDN is exactly when the file goes missing or starts being served as HTML.
  • Remove lines when you leave a partner. Don't do it the day you give notice. Do it once they've actually stopped selling for you.
  • Watch for duplicates and conflicts. The same account listed as both DIRECT and RESELLER usually means someone copied lines without checking. Ask the partner which one is right.

A tidy file won't raise your revenue on its own. A broken one, though, can cut it quickly and quietly, which is why it's worth the routine.

How to check it

  1. Open yoursite.com/ads.txt in a private browser window.
  2. Confirm it's plain text, and every partner's lines are there.
  3. Check the ads.txt status shown in your Google products. Ad Manager and AdSense both report problems they find, though crawls can take some days to update.

ads.txt is one half of the picture. The other half is published by the ad systems themselves: see sellers.json explained. And if your revenue suddenly dropped, a broken ads.txt is one of the first things to rule out in diagnosing revenue drops.

Talk to us about joining Bidora MCM. We send Manage Account invitations, you choose our share starting at 8%, and IVT Shield is included. Start on the Get started page or email partnership@bidora.one.

Ready when you are

Tell us about your site. We'll take it from there.