Onboarding Guide

Troubleshoot your feed

Troubleshoot your feed [hero image]

At times, you may need help troubleshooting your feed. Our goal is to provide answers to specific problems that you might encounter when using feeds and Google Merchant Center.

If your account has been disapproved and your feeds seem to be correct, please view consolidated issue reporting for the Shopping product data across your account, feeds, and items in the "Diagnostics" page, located under “Products”.

Troubleshoot your feed | Feed creation issues [icon] Feed creation issues
Troubleshoot your feed | Feed registration issues [icon]Feed registration issues
  • Country of sale: Specify the primary location where your items are sold. For example, if you specify “United States” as your country of sale, this indicates that your items are available for purchase in the US. The product data uploaded to a selected country must meet the requirements for that country, including the feed specifications and policies.
  • Multiple countries: Specify multiple countries of sale if you sell the same product in multiple countries. Ensure your products meet the requirements for each country, including the feed specifications and policies.
  • Data feed file name: RSS and Atom files should end with an .xml extension. Filenames that don't end with any extension will be processed as a tab-delimited file by default and should end with (.txt). Remember that we do not accept files in Excel format. See converting your spreadsheet for help.
  • When using filename extensions like .zip or .gz, you must ensure that the file is compressed because our system assumes that the file is compressed. Uploading an uncompressed file in this case may cause feed failure. Please make sure that the compressed archive contains exactly one file.

Please note, when editing your data feed settings we recommend you leave "autodetect" as the selected option unless a specific problem needs to be addressed.

Troubleshoot your feed | Formatting issues Formatting issues
  • Text or tab-delimited
    • If you are using previously formatted text (anything with line breaks or quotations), make sure your feed has quoted attributes turned on.
    • Make sure that your columns (tabs) with the required attributes correctly match all the items; oftentimes there will be either an extra tab or a missing tab.
    • If you’re using Google Sheets, the Google Merchant Center add-on can help you validate your data.
  • XML
    • You cannot include un-escaped special characters like "&".
    • Your attribute names may contain capital letters, any capitalization in your attribute names should be removed. For example, the title attribute should be entered as <title>, instead of <Title>.
    • Incorrect encoding sometimes occurs. Be sure to encode your file in the accepted formats.
Troubleshoot your feed | Upload issues [icon]Uploading issues
  • Your feed may be too large for the upload method you're using.
    • Direct upload files must be less than 4 GB in size. (If you're encountering an "oops" message from this method, please wait a few hours and try again.)
    • SSH File Transfer Protocol (SFTP) and File Transfer Protocol (FTP) files must be less than 4 GB in size.
    • Files set for scheduled fetches must be less than 4 GB in size.
  • Commonly, automatic uploads fail because:
    • The URL used for scheduled fetch is roboted or does not have permission settings for Merchant Center to download the data feed.
    • The URL used for scheduling is not working or redirects to a page that doesn’t contain the data feed.
  • Compressed files must be smaller than 500 MB.

Here are some of the most common errors encountered using SFTP and FTP.

Issue Solution
Server not found error

For FTP, verify you're signing on to ftp://uploads.google.com. If you're using an FTP client, remove ftp://; and use uploads.google.com.

For SFTP, verify you're signing on to {sftp username}@partnerupload.google.com with a specified server port of 19321. If you're using an SFTP client, you may need to prefix the host name address with the ‘sftp://’ protocol (e.g., sftp://partnerupload.google.com).

Username or password incorrect Click here for help with SFTP and FTP login issues.
"Can't build data connection" or "FTP folder error" You will need to upload using passive FTP.
"Filename not allowed" error Ensure that your filename does not contain spaces. The name of your file should exactly match the name of the filename you registered in your account.
You don't have a data feed registered with this name Ensure that the name of the file you’re submitting via SFTP or FTP exactly matches the file name provided when registering your data feed.
"FTP connection reset by peer" error The Internet connection to our FTP server was lost. Please try uploading your file again. If your file is under 200 MB in size, you can also upload your file directly through the Google Merchant Center data feeds page. If your file is larger than 200 MB, try splitting your data feed into multiple files smaller than 200 MB. The smaller file size will allow you to upload your files through your dashboard.

For specific problems with SFTP and FTP not answered within this page read this article.

If you'd like to review your uploaded feed during your investigation, follow these steps to download it:

  1. Sign in to your Merchant Center account.
  2. Select Products from the left-hand navigation menu, then click Feeds.
  3. Under the "Feed" column, click the feed name.
  4. Under the "Processing" tab, click the 3-dot icon 3 dot icon on the far right.
  5. Select the option to Download file.
You may also try exporting your entire feed to Google Cloud using Merchant Center export (beta)

Note that only users who belonged to the merchant account at the time the file was uploaded have the right privileges to download the feed.

You’ll be able to download a CSV report detailing processing errors and warnings after you’ve uploaded your feed. When a report is available, you’ll see an option to download the report in the feed summary page next to the "Download file" button. The report will contain identifying information for errors at the top, followed by a table with details on individual items and their feed errors and warnings. Please note that the report will only be available for 14 days after you’ve uploaded your feed and will only detail up to 100,000 errors and warnings combined.

You may also be able to use feed rules to correct missing or incorrectly formatted attributes in your feed without editing its content.

Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue