Search
Clear search
Close search
Google apps
Main menu

Fix error messages in uploaded HTML5 ads

When uploading creatives in AdWords, you may receive an error message. In most situations, the problem can be fixed by altering your file and re-saving. You can then try to upload your file again.

Check your ads using the AdWords HTML5 validator.

This article will help you respond to specific error messages that you may receive while trying to upload creatives. For more detailed requirements, check our Image Policy page.

HTML5 ads

HTML5 ads created using the Swiffy tool are not supported. Upload the original Flash file

To convert your Flash ads to HTML5, only upload Flash files to AdWords. If you use the Swiffy conversion tool, the ads will not be accepted. You can also rebuild the ads using Google Web Designer or other tools. Learn more about converting your Flash ads to HTML5.

The ad contains an unsupported file type. To fix the issue, remove any unsupported file types.

To see if your .ZIP contains an unsupported file type, try the following:

  1. Open the .ZIP by double-clicking on it.
  2. In the resulting folder, make sure that each file is one of the supported file types: .CSS, .JS, .HTML, .GIF, .PNG, .JPEG and .SVG. If you find one that is not supported, remove it.
  3. To save your updated version, select all of the files in the folder, and click File > Compress items.
  4. If your folder doesn't zip correctly, it might be because you compressed the folder. Make sure to select each item, not the entire folder.
The file size for your ad is too big. Upload an ad less than 150 KB in size.
Note that the 150KB applies to all of the files in your zip. You can check the size of your files by selecting the files and using File > Get Info or File > Properties, depending on your computer. The popup box will indicate the size in KB.
The ad you uploaded includes a file path or file name with characters other than letters, numbers, periods (.), hyphens (-), and underscore (_). 

To see if your .ZIP file contains filenames with unsupported characters, try the following:

  1. Open the .ZIP file by double-clicking on it.
  2. In the resulting folder, make sure that each file uses only supported characters: letters and numbers. Rename files with file names that contain characters other than letters, numbers, periods (.), hyphens (-), and underscore (_). If you have subfolders in your .ZIP file, make sure to open and inspect those files, too.
  3. To save your updated version, select all of the files in the folder, and click File > Compress items.
  4. If your folder doesn't zip correctly, it might be because you compressed the folder. Make sure to select each item, not the entire folder.
The ad you uploaded contains HTML5 code that does not meet AdWords policies.

To fix the issue, search for the above unsupported tags in your creative code. You’ll need to check all files stored within your .ZIP file and delete them.

In many cases, the issue is with unsupported .SVG tags. In that case, search your creative code for tags that are not included in one of the supported categories (container elements, gradient elements, and graphics elements). Learn more about which supported tags are mapped to which categories.

Your HTML5 ad is missing a primary .HTML file. Make sure there's an .HTML file with an Ad Size tag in your HTML5 ad, and try again. An Ad Size tag should look like <meta name=”ad.size” content=”width=300,height=250”>.

Primary .HTML files include an Ad Size tag such as <meta name=”ad.size” content=”width=300,height=250”>.

  1. Open your .HTML file and search for the Ad Size meta tag. If you find it, make sure it’s contained in the <head> tag and that the <head> statement is closed with a </head>.
  2. Replace quotation marks manually as copy/pasted ones can throw an error (are not accepted by AdWords).
  3. This error can also appear when you try to upload files from DCLK Studio or the Swiffy tool. Those files are not accepted by AdWords and cannot be uploaded. DCLK should be trafficked via 3PAS per usual and Swiffy Flash files should be uploaded as Flash, not converted HTML5.
Your HTML5 ad is trying to reference an asset that we can't find in your .ZIP file.

Make sure the filenames of all files in your .ZIP file are exactly the same as the name listed in the reference file.

For example, if one of the files in your .ZIP file is called path/to/example/asset, but in your HTML file you reference path/to/example/asset2, AdWords will not be able to to find the correct file.

To fix the issue, compare the filename listed above with every file in your HTML5 code. If it is not exactly the same, correct the reference.

Your HTML5 ad is trying to reference an asset not found in your .ZIP file. Make sure your .ZIP file only references internal assets.

You can only reference files found in your uploaded .ZIP file, and the file listed above is not found there. To continue, remove any references in your HTML file to assets found outside of the .ZIP file.

The asset listed in the error message cannot be found in your .ZIP file.  You will also need to remove any references to that file. The only allowed external references are the following:

  • Google Fonts
  • Google-hosted jQuery
The .ZIP file can't be processed because the file itself or one of the files inside it was corrupted.

To fix corrupted files inside of your .ZIP, try the following:

  1. Open the .ZIP file by double-clicking on it.
  2. In the resulting folder, open each individual file and save it again.
  3. To save your updated version, select all of the files in the folder, and click File > Compress items.
  4. If your folder doesn't zip correctly, it might be because you compressed the folder. Make sure to select each item, not the entire folder.

Google Web Designer HTML5

You must upload a published file. You must publish your file in Google Web Designer before you can upload it to AdWords.
To upload your ad, you must upload a published file, not the author file. Before you can upload your ad, you must open the author file in Google Web Designer and choose the options: Publish > Publish Locally. Learn more.
This ad was created with the environment "Generic" instead of "AdWords". To continue, convert the file to an "Adwords" environment in Google Web Designer.
When creating the ad, you selected the wrong environment. Your ad was created with the “Generic” environment instead of “AdWords”. To continue, you must convert the file to an “AdWords” environment. Learn more about environment conversion.
The ad you uploaded contains HTML5 code that violates AdWords policies. Remove any references to the tags listed above before you upload your ads.

Your ad violates one of the AdWords policies. See problems listed in the original error message.  

Before you can upload your ad, you'll need to remove any unsupported features. You can do this by opening the index.html file in your .ZIP file. You can find unsupported features in the "gwd-admetadata" section.

  • Expandable ad: Search "creativeProperties." The minWidth should equal maxWidth and minHeight should equal maxHeight.
  • Counters or timers: search “counters” or “timers”. These arrays should be empty.
  • Multiple exits
  • Videos
  • Maps
  • You can find a complete list of Supported features here.
Your HTML5 ad is trying to reference an asset not found in your .ZIP file. Make sure your .ZIP file only references internal assets.

In Google Web Designer, you must include images for all visual states of the image button.

For example, in the below code snippet from an example index.html file, the images for the up-image, over-image, and the down-image are missing (see bolded text).

<gwd-imagebutton id="gwd-imagebutton_1" up-image="" over-image="" down-image="" scaling="cover" class="gwd-imagebutton-tcf2"></gwd-imagebutton>

Learn more about the image button component.

To fix the issue, replace the placeholder.png with the image(s) you want to use and make sure the image is included in the .ZIP file.

Note: The error message should explain what is missing. In some cases, you’ll see "" as missing. In this case, it's likely that the image location wasn't specified. Open your .ZIP file and locate your index.html file. Inside, you can search for ' ="" to find the error.

Was this article helpful?
How can we improve it?
Sign in to AdWords

Get account-specific help and tips by signing in with your AdWords account email address, or learn how to get started with AdWords.