ads.txt & sellers.json

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

Last updated Published By the editorial team6 min4 sources

Key takeaways

  • 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.
  • Google publishes one sellers.json at realtimebidding.google.com/sellers.json, covering AdSense, AdMob and Ad Manager accounts, with your publisher ID as seller_id.
  • In AdSense, the Seller information visibility section under Account, Settings, Account information lets you choose Transparent, which lists your payee name and optional business domain.
  • Google says a transparent name and domain appear in its sellers.json within 24 hours, and that your transparency status and domain are shared across AdSense, AdMob and Ad Manager.
  • Google warns that changing your sellers.json name triggers an automatic payment delay of 2 weeks, because the name comes from your payments profile.
Balance scale
Image: Balance scale IMGP9755,Nikodem Nijaki,CC BY-SA 3.0,via Wikimedia Commons.

sellers.json is the public file in which an ad system lists the sellers it pays. Google’s file covers AdSense, AdMob and Ad Manager, keyed by publisher ID. In AdSense you choose whether your entry is “Transparent” (your payee name and optional business domain are shown) or confidential (only your ID and seller type). Neither choice affects ads.txt authorization, but Google says hidden names may affect revenue.

What is sellers.json and how does it relate to ads.txt?

The two files answer opposite questions:

File Published by Answers
ads.txt You, on your domain Which seller accounts may sell my inventory?
sellers.json The ad system (Google), on its domain Who is the business behind each seller account?

Your ads.txt line google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0 says that publisher ID may sell your inventory through Google. The IAB Tech Lab Sellers.json specification lets a buyer take that ID, look it up in Google’s file, and see whether it belongs to a publisher or an intermediary and, if the seller is not confidential, its name and domain. The spec describes the goal as allowing “the identity of the final seller of a bid request to be discovered (assuming that they are ads.txt authorized)”. Line format details are in ads.txt syntax.

Where is Google’s sellers.json?

Google’s help page Provide your seller information with sellers.json points to realtimebidding.google.com/sellers.json. When we fetched it on November 18, 2026, that URL answered with a 302 redirect to a file on storage.googleapis.com, served as application/json, about 99 MB in size. The top of the file declares Google’s contact email, the TAG-ID f08c47fec0942fa0 (the same value as the fourth field of the AdSense ads.txt line), "version": "1.0", and a notice that reads “This file is a beta and is unverified.”

In that copy, we counted 885,909 seller entries. 885,327 had seller_type PUBLISHER, 582 had BOTH, and none had INTERMEDIARY. 616,875 entries were confidential. These counts describe one download, include AdSense, AdMob and Ad Manager accounts, and will change over time.

What fields does your entry contain?

Google’s help page lists five fields:

Field What Google puts there
seller_id Your publisher ID, for example pub-1234567890123456
is_confidential Set when your name and domain are hidden
seller_type PUBLISHER, INTERMEDIARY or BOTH
name The name from your payments profile, only when transparent
domain Your business domain, only when transparent and verified

Google’s rule for seller_type: “If you own the site you’re monetizing and/or you’re paid directly by Google, then you’re classified as PUBLISHER. If not, you’re classified as INTERMEDIARY.” Accounts in both situations are BOTH.

In the downloaded file, a confidential AdSense entry looks like this:

{
  "seller_id": "pub-0000000000000000",
  "is_confidential": 1,
  "seller_type": "PUBLISHER"
}

A transparent entry has no is_confidential key at all, and adds the name and, when set and verified, the domain:

{
  "seller_id": "pub-0000000000000000",
  "seller_type": "PUBLISHER",
  "name": "Example Media LLC",
  "domain": "example.com"
}

Omitting the key is valid: the spec defines is_confidential as an optional integer with a default of 0.

How do I make my seller information transparent?

The steps from Google’s help page:

  1. Sign in to AdSense.
  2. Click Account, then Settings, then Account information.
  3. In the “Seller information visibility” section, select Transparent.
  4. Optionally, add your business domain and click Verify and add.

Google says your name, domain (if included) and publisher ID “will appear in the Google sellers.json file within 24 hours.”

Before you switch, check the name. It is not a free-text field: it comes from the “Name and address” section (individual accounts) or “Business name and address” section (business accounts) of your payments profile. Google warns: “If you change your name, this will result in an automatic payment delay of 2 weeks.” If your payee name needs fixing for other reasons, the trade-offs are covered in payee name and bank account mismatch.

Transparent or confidential: what changes for you?

Google’s position is that you should be transparent: “If your information isn’t made transparent, advertisers won’t be able to see your name, which might impact your revenue.” The help page does not quantify that effect, and neither does any other official Google page we found, so treat it as a possible effect, not a number.

Transparent Confidential
Visible to anyone who downloads the file Publisher ID, seller type, name, domain if verified Publisher ID, seller type
Personal name exposed (individual accounts) Yes No
Buyers can link your ID to a business Yes Only through other data
Affects ads.txt status No No
Shared with AdMob and Ad Manager accounts Yes Yes

For an individual account, “Transparent” publishes your legal name in a file that anyone can download and that data companies archive. For a company, publishing the company name is usually low-risk. That is the decision you are making.

What is the business domain, and which one should I use?

Google defines it as “the domain for your corporate entity, not necessarily the domain where inventory is being monetized.” If the only domain you own is the one you monetize, list that one. The rules:

  • Use the root domain: example.com or example.co.uk.
  • No scheme (https://), no www., no other subdomain, no trailing slash.
  • The domain must use a suffix on the Public Suffix List; Google gives google.ltd and google.tech as unsupported examples.
  • It “may be hidden in sellers.json until we have verified that you own the URL.”
  • If your account is confidential or you have no web presence, you do not need one.

This domain matters for ads.txt 1.1: the IAB spec says the OWNERDOMAIN value in your ads.txt should match the domain of your sellers.json entry. That link is explained in OWNERDOMAIN and MANAGERDOMAIN.

Is the setting shared with AdMob and Ad Manager?

Yes. Google says that “your transparency status and domain will be shared across all products. It’s not possible to be confidential for one product and transparent in another.” Turning on transparency in AdSense also turns it on for your AdMob and Ad Manager accounts, and the business domain propagates the same way. Each product keeps its own seller_id.

Intermediaries and BOTH accounts are not given the choice: Google says they “have is_confidential set to false by default” and do not have the “Seller information visibility” control. If you are considering a move to Ad Manager or working with a partner, see AdSense vs Ad Manager.

How do I find my own entry?

Google suggests downloading the file and searching it with Ctrl+F (Command+F on a Mac). At about 99 MB that can be slow in a browser or text editor. From a terminal:

curl -sL https://realtimebidding.google.com/sellers.json -o sellers.json
grep -A4 '"pub-0000000000000000"' sellers.json

Replace the zeros with your publisher ID (in AdSense under Account, Settings, Account information, in the “Publisher ID” field). -L is required because of the redirect; without it, curl stores an empty redirect response. -A4 prints the four lines after the match, which covers the rest of a small entry, because the file is pretty-printed with one key per line.

If your ID is not found, check that you used the pub- form without the ca- prefix. If you just switched to Transparent, wait 24 hours and download again.

What can go wrong?

What you see Likely reason What to do
Entry still confidential after switching Less than 24 hours, or a cached copy Download the file again later
Name shown, domain missing Domain not added or not yet verified Add it under “Seller information visibility” and complete verification
Wrong name shown Payments profile name Change it knowing the 2-week payment delay
Name visible after switching back to confidential Old copies of the file Google notes past transparent data could still be visible
seller_type is BOTH or INTERMEDIARY Google’s classification of the account Review how inventory is owned and paid; there is no toggle

Where Google’s documentation and the file differ

Two details in Google’s help page do not match the file we downloaded. The help page’s example uses "sellerId" and "sellerType", while the actual file and the IAB spec use seller_id and seller_type. The help page describes is_confidential as “true”, while the file uses the integer 1, as the spec requires. If you write scripts, follow the real file and the IAB specification, not the help page example. The other open specifications in the same family are mapped in IAB Tech Lab specs.

Frequently asked questions

Do I have to make my AdSense seller information transparent?

No. Confidential is a valid choice and does not stop ads from serving. Google encourages transparency and says that if your information isn't transparent, advertisers won't be able to see your name, which might impact your revenue. Weigh that against privacy: for an individual account, the name listed is your personal payee name from the payments profile.

Which name appears in sellers.json?

The name from your AdSense payments profile: the "Name and address" section for individual accounts, or the "Business name and address" section for business accounts. You cannot type a separate display name. Google warns that changing this name causes an automatic payment delay of 2 weeks, so check the payments profile before switching to Transparent.

How long does it take for my entry to change?

Google says your name, domain if included, and publisher ID appear in its sellers.json within 24 hours after you select Transparent. The business domain may stay hidden until Google has verified that you own it. Buyers and tools that cache the file may take longer to reflect the change on their side.

If I switch back to Confidential, is my name removed everywhere?

It is removed from future versions of Google's file, but Google notes that your publisher ID stays the same, so seller information from the period when your status was transparent could still be visible to external parties. Anyone who saved an earlier copy of the file, or built a database from it, keeps that history.

Sources

  1. Provide your seller information with sellers.json · Google AdSense Help
  2. Sellers.json · IAB Tech Lab
  3. sellers.json Supply Chain Transparency · IAB Tech Lab
  4. Ads.txt Version 1.1 · IAB Tech Lab