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.

Review feed processing results

You're able to review the results of all feed processing for file-based or Google Sheets-based feeds. To find the results:

  1. Sign in to your Merchant Center account.
  2. From the navigation menu, click Products, and then click Feeds.
  3. Click the primary or supplemental name of the feed that you'd like to review.
  4. Review the results:
    • Properties: Includes key feed properties, which vary depending on the input method of the feed. Here, you can find attributes such as input method, time zone, file size, detected delimiter (if applicable) and more.
    • Attributes: Your feeds need to adhere to the product data specifications for the programmes that you're opted in to. In this section, you can review all of the attributes that we found in your feed, including those attributes which are recognised and map to the feed specification, and also unrecognised attributes which do not match the ones listed in the product data specification. You may review the list and use tools such as feed rules to tell Merchant Center which unrecognised attribute you would like to use to populate a Google attribute. For example, you may want to use 'product name' in the 'title' attribute.
    • Processing data: In this section, you can review the number of items found in your feed, as well as those with any detected item issues. Review the list of item issues to understand how many items in your feed are impacted, including examples and links to documentation to address the issue.

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'.

Note: Processing only checks for basic file and data issues. To see all issues, go to Diagnostics.

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 that your products meet the requirements for each country, including the feed specifications and policies.
  • Data feed filename: 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 such as .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 that 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're using previously formatted text (anything with line breaks or quotations), make sure that your feed has quoted attributes turned on.
    • Make sure that your columns (tabs) with the required attributes correctly match all the items; often, 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 capitalisation in your attribute names should be removed. For example, the title attribute should be entered as <title>, instead of <Title>.
    • Incorrect encoding sometimes occurs. Make sure that you 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 that 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 robotted 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 that 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 that 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'll 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 that you registered in your account.
You don't have a data feed registered with this name Ensure that the name of the file that you're submitting via SFTP or FTP exactly matches the filename 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 created your feed using one of the upload methods and would like to review it during your investigation, follow these steps to download it. Note that there is no file to download for Content API feeds.

  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 three-dot icon 3 dot icon on the far right-hand side.
  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 that 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

Search
Clear search
Close search
Google apps
Main menu
Search Help Centre
true
71525
false