Impress your clients with simpler ad approvals today!

HTML5 banner QA checklist: 12 checks before you upload

November 20, 2026

Most rejected HTML5 banners fail on a handful of things: file size, a missing size tag, a broken clickTag, or file paths that point outside the ZIP. Check these before the client approves, so approval doesn’t need a second round.

The limits below are Google Ads’ rules, checked in November 2026. Other ad servers and publishers have their own specs, so always check the media plan.

Note: these checks are for uploading to your ad server, such as Google Ads, Campaign Manager 360 or Display & Video 360. Uploading to Adpiler for a client preview is much less strict. Adpiler’s smart uploader accepts your ZIP files as they are, so you can share work in progress with your client and do the final checks before trafficking.

The checklist

File and package

  • 1. ZIP size within the limit. In Google Ads, the compressed ZIP may be no more than 600 KB. Display & Video 360 allows larger files but limits what the browser downloads to 5 MB. Publishers often ask for much less.
  • 2. File count. Google Ads accepts one HTML file plus up to 39 other assets, so 40 files at most.
  • 3. Correct ZIP structure. Zip the files, not the folder around them. The main HTML file should sit at the root of the ZIP.
  • 4. Safe file names. Use only letters, numbers, periods, hyphens and underscores. Google Ads rejects other characters, including spaces.
  • 5. Relative paths only. Every image, script and font must be inside the ZIP and referenced with a relative path. External references are not allowed in Google Ads, with a few exceptions such as approved libraries.

Code

  • 6. Size meta tag. The HTML must declare its size in the head, for example <meta name="ad.size" content="width=300,height=250">. Without it, Google Ads can’t find the primary HTML file.
  • 7. Working clickTag. Don’t hardcode the landing page URL. Use the clickTag variable your ad server expects, and test that a click opens a new tab.
  • 8. HTTPS-ready. Everything must load over HTTPS, or the ad won’t serve on secure sites.

Animation and behaviour

  • 9. Animation length. Google Ads does not allow animations longer than 30 seconds, loops included. Many publishers ask for 15 seconds or less.
  • 10. A strong end frame. When the animation stops, the last frame stays on screen. It should show the logo, the message and the call to action.
  • 11. Cross-browser test. Check Chrome, Safari, Firefox and Edge, on desktop and mobile. Safari can run animations slower than other browsers. We explain why and how to fix it.

Delivery

  • 12. Backup image. Many ad servers ask for a static backup image for browsers that can’t show the HTML5 ad. For Google Ads image ads, the limit is 150 KB. Adpiler’s image generator creates backup images from your HTML5 file.

Do the QA before the client sees it

The best moment for these checks is before the client approves. If a banner fails the ad server after approval, you fix it and the client has to approve it again. Upload your banners to a preview page to see every size play in the browser. Then check the list above before you share the link.

Google also offers an HTML5 validator for Google Ads uploads. Google Web Designer has a built-in Ad Validator.

FAQ

What is the maximum file size for an HTML5 ad in Google Ads?

600 KB for the compressed ZIP, with up to 40 files in total.

Why does Google Ads say my HTML5 ad is missing a primary HTML file?

Usually the ad.size meta tag is missing from the head, or the HTML file sits in a subfolder inside the ZIP.

How long can a banner animation be?

In Google Ads, 30 seconds at most, loops included. Check the publisher’s specs as well, because many ask for 15 seconds.

Do I need a backup image for HTML5 banners?

Most ad servers ask for one or create one automatically. Make sure it shows the key message, because some users will see only that.

Check every size in the browser before your client does. Try Adpiler free for 14 days.

Adpiler is a huge time-saver “Before using Adpiler, we hosted the banners on our own server and created a simple HTML-file to list them all. That took us a lot of time. Adpiler is a huge time-saver for us.”
John Doe
Designer

Jorrit

Founder Adpiler