Skip to content
HTML5 and playable ads

HTML5 Banner Checker

Drop your banner ZIP and see what the ad server will reject: weight, clickTag, ad.size, external requests, missing files, with a live preview.

Last checked

Files never leave your device. Everything runs in this tab.

600 KB, 40 files, HTML, CSS, JS and images only, relative paths, ad.size meta, one of Google's 20 HTML5 sizes. Google Fonts and Google-hosted CreateJS, GreenSock and jQuery may load from outside the ZIP. Source: Google Ads help, requirements for HTML5 ads.

  • ZIP size and file count against the network
  • ad.size meta tag, page size and backup image size
  • clickTag, Studio Enabler exits and hard-coded links
  • External and insecure requests, missing files
  • Backup image, unused and stray files
  • Live preview with a click test, one ZIP or a whole set

How to use it

  1. Pick the network you are building for under Check against.
  2. Drop the banner ZIP on the box, or several ZIPs for a whole set. A clean and a problem sample are there to try.
  3. Fix the failed checks from the top, read the notes, then click the live preview to test the clickTag.

What it checks and why

Ad servers reject a banner for small reasons: the page sits in a folder inside the ZIP, the ad.size tag is missing, a font loads from a CDN, a file name differs in case from the reference. Each of these is cheap to find with a script and slow to find by uploading and waiting for the error.

The checker opens the ZIP in your browser, runs the rules of the network you pick and lists every problem with the change that fixes it. It also finds files nothing references, so you can cut weight, and it flags system files such as __MACOSX that Mac zip tools add.

The preview runs your banner in a sandboxed frame with a test clickTag. When you click it, the page shows the URL the banner tried to open, which is the quickest way to see that the click goes through the clickTag and not a hard-coded link.

Specs and sources

Limits

  • The rules are the published ones. A network can reject a banner for reasons no script can see, such as policy or content.
  • The preview runs the files from the ZIP as data URLs. A script that builds file paths at run time will not find its files there, though the ad server may serve them fine.
  • The 150 KB target is a common publisher request, not a rule of any one network.
  • Animation length and loop count are not measured yet; watch the preview timer and keep animation under 30 seconds.
  • Google Ad Manager has no profile of its own yet.

Questions

What is a clickTag?
A variable named clickTag that holds the landing page URL. The ad server sets it, and the banner opens it with window.open(window.clickTag). The name is case-sensitive.
Why must index.html be at the top level of the ZIP?
Ad servers look for the page in the root of the archive. Zipping the folder that holds the files adds a level, and the upload fails. Select the files, not the folder, when you zip.
How big can an HTML5 banner be?
Google Ads allows 600 KB and 40 files. Display & Video 360 counts up to 5 MB of files the browser downloads. Campaign Manager 360 takes a ZIP up to 9.5 MB with 100 files. Publishers often ask for 150 KB.
Can a banner load a font or a library from a CDN?
On Google Ads only Google Fonts and the Google-hosted CreateJS, GreenSock and jQuery are allowed; Google serves CreateJS and GreenSock from s0.2mdn.net. Everything else has to be inside the ZIP and referenced by a relative path.
Does every Google Ads account accept HTML5 banners?
No. Google lets an account upload HTML5 ads once it has been open for more than 90 days, has more than 9,000 USD lifetime spend and a good policy record. Others can use image ads or responsive display ads.
What is the 150 KB limit people mention?
Two things share the number: Google Ads' limit for image ads (GIF, JPG, PNG), and the IAB initial-load weight for most core sizes such as 300x250 and 728x90. Google's HTML5 limit is 600 KB.
My Google Web Designer banner fails the clickTag check. Why?
Studio banners exit through the Enabler (Enabler.exit) instead of a clickTag. Pick Campaign Manager 360 or Display & Video 360 and the checker accepts it. For Google Ads, publish from Google Web Designer with the Google Ads environment.
Is this an h5validator alternative?
It runs the same kind of checks as Google's HTML5 validator (size, file count, ad.size, clickTag, external files) against the published rules, in your browser, for one ZIP or a whole set.