Clear search
Close search
Google apps
Main menu

Google Publisher Toolbar

Overlay information about each ad on your webpage

The Google Publisher Toolbar is a Chrome extension that provides in-site ad overlays and details about the ad request, ad unit, order, line item, and creative. The Google Publisher Toolbar helps you to resolve DFP delivery issues, such as:

  • What line item and creative is showing in a particular ad slot
  • Why an ad slot might be showing an unexpected line item or creative
  • Why an ad slot is blank


Learn more about Google Chrome and Chrome extensions.

Not using the Chrome browser?
Use our other troubleshooting tools to diagnose issues affecting your site.

Delivery Inspector
Answers which ads delivered on your app or page, why these ads delivered and not others, which line items would deliver if you were to request the ad slot again, and more.
  Google Publisher Console
Checks your page for many common JavaScript tagging errors, identifies all of the ad units and creatives on the page, and helps you visualize the ad request behavior of a page.

Set up the Google Publisher Toolbar

These instructions are specific to DoubleClick for Publishers and Ad Exchange, but you can also use this extension with your AdSense account.

Enable your DoubleClick for Publishers account

  1. In DFP, enable API access.
  2. In Chrome, click Google Publisher Toolbar icon that looks like a white line graph against a blue background. to open the Google Publisher Toolbar extension.
  3. Click Enable next to the DoubleClick for Publishers logo.

    If you're already using the Google Publisher Toolbar with Ad Exchange or AdSense, click Accounts at the bottom of the toolbar window first.

Enable ad slot overlays

  1. In Chrome, click Google Publisher Toolbar icon that looks like a white line graph against a blue background. to open the Google Publisher Toolbar extension.
  2. Click the settings icon Google Publisher Toolbar options icon and then click Sites from the dropdown.
  3. In the Sites authorized to show ad overlays textbox, add the domain (or URL) of the sites you own and authorize to show in-site ad overlays. Enter one domain per line. The site must be one that you own to be able to see any ad overlays.
  4. Click Save.

Use the Google Publisher Toolbar

View ad details from the Ad Details window

When you click an ad overlay, the “Google Publisher Toolbar - Ad Details” window loads. The "Ad Details" window offers a more detailed view of the ad:

  • Name or ID of the ad slot
  • Ad type and size
  • Performance metrics, such as clicks, eCPM and estimated revenue
  • Buyer name
  • Deal ID (if you have a Preferred deal)
  • Agency name
  • Advertiser name
  • Display URL
  • Destination URL
  • Preview of the ad
Currently, the toolbar only shows detailed data in the "Ad details" window for creatives that are served from Ad Exchange or AdSense. If a creative is served from DFP, no information is available.

Block an unwanted ad

Ad overlays provide access to the "Ad Details" window, which enables you to block ads as you view the site. When you see an ad that isn’t suitable for your audience, you can take action immediately without any need to visit the account to investigate which ad to block.
If you've not already done so, you need to enable Creative review before you can block individual ads. Creative review is enabled for your account within one hour.
  1. On your site, click the overlay of the ad you want to block. This opens the "Google Publisher Toolbar - Ad Details" window.
  2. Below the ad preview, click the drop-down and select Block this ad. You'll see the blocked ad next time you visit the Blocked tab in Creative review.
Blocking ads can lower your potential revenue
Blocking an ad reduces competition for ad space by removing advertiser bids from the auction. We suggest blocking only those ads that you feel are unsuitable for your users.

Report a problem with an ad

If you see a problem with an ad on your site (for example, the ad is broken or the ad is not family-safe), there are a couple of ways to report the issue to the appropriate Google support team. You can either report the problem ad from a predefined list of reasons or export the ad details and a screenshot.

Select from a predefined list of reasons

You can report the issue via the “Ad details” window, which is accessed through an ad overlay. When you report a problem ad, all available reporting data at the time of the impression is sent to the appropriate Google team.

  1. Click the overlay of the ad you want to report. The “Google Publisher Toolbar - Ad details” window loads.
  2. Under the ad preview, click the Report a problem with this ad drop-down and select the issue that you want to report. For example, you could choose: "This ad is not family-safe or is inappropriate."
  3. (Optional) To include extra information about the problem, use the additional comments field (maximum of 140 characters).
  4. Click Send.

Export ad details

Alternatively, you can export the details of the ad from the "Ad details" window and then email the exported information. When you export an ad's details, all available data at the time of the impression, including a screenshot of the ad, is downloaded into an HTML file.

  1. Click the overlay of the ad you want to export. The “Google Publisher Toolbar - Ad details” window loads.
  2. In the "Ad details” window, click Export ad details.
    The ad details are downloaded into an HTML file, which is then available for you to use as needed.

Detect misconfigured ad requests

The Google Publisher Toolbar automatically detects issues with ad requests that can lead to problems with our content and site targeting systems. The Toolbar displays a notification at the top of pages where misconfigured ad tags have been detected. Learn more


The Google Publisher Toolbar works with Google Publisher Tags (GPT) but doesn't work with every site layout or ad request. We don't guarantee that it will work on your site. We've designed the toolbar to work with the most common combinations of ad requests and page layouts, but if you've done something especially unique on your site, the toolbar might not be able to handle it. We're continually improving the toolbar so that it will work with as many sites and configurations as possible.

Why does my ad overlay not appear?

Currently on our platform, we only support ads served through Google Publisher Tags (GPT), AdSense ads, and Ad Exchange ads. In some cases, when we cannot determine the correct tag information for an ad request, we may not render overlays. Here are some possible reasons why:

  • Your ad code is nested within multiple iframes.
  • You’re using a Supply-Side Platform (third-party ad servers, yield managers, etc.) for ad optimization.

In an effort to continuously improve our product, we plan to address these limitations in the near future. In the meantime, use Creative review to view ad details and block ads.

Can I use this extension in Incognito mode?

Yes. The Google Publisher toolbar can be used with an incognito window, but you must first allow the toolbar to work in incognito mode before you can access the account overview.

  1. On the browser toolbar (in the upper-right corner), click the Chrome menu icon.
  2. In the controls drop-down, hover over Tools and click Extensions
  3. From the list of extensions, locate Google Publisher Toolbar.
  4. Select Allow in incognito.

What does incognito mean?

For times when you want to browse in stealth mode, Google Chrome offers the incognito browsing mode.

  • Webpages that you open and files downloaded while you are incognito aren't recorded in your browsing and download histories.
  • All new cookies are deleted after you close all incognito windows that you've opened.
  • Changes made to your Google Chrome bookmarks and general settings while in incognito mode are always saved.
Was this article helpful?
How can we improve it?