PrestaShop Google Merchant Feed XML

PrestaShop Google Merchant Feed Documentation

1. Introduction
2. Installation and system requirements
3. Module activation
4. Basic feed configuration
5. Advanced configuration
6. XML feed structure
7. Product filters
8. Integration with Google Merchant Center
9. Automatic refresh (CRON)
10. Security and tokens
11. Logging and debugging
12. Image sizes
13. Troubleshooting
14. FAQ

1. introduction

• Automatic generation of XML feeds for Google Merchant Center
• Support for all required and optional Google Shopping fields
• Advanced product filtering (categories, manufacturers, quantity, promotions)
• Support for multiple languages and currencies in the store
• Additional product images (up to 10 per product)
• Automatic feed refresh by CRON
• Secure access using tokens
• Feed caching for performance optimization
• Data normalization – removing HTML, highlighting, and spaces
• URL and data format validation
• Compatible with PrestaShop 1.7.x, 8.x, and 9.x
• Full translation system (Polish, English, German, Spanish, French)

2. installation and system requirements

• PrestaShop 1.7.0.0 or newer (tested up to version 9.0)
• PHP 7.4 or later
• Access to the PrestaShop admin panel
• Google Merchant Center account (free)
• Ability to save files on the server
• Access to CRON (optional, for automatic refresh)

1. Download the ZIP file of the module from the official website. cocos.codes
2. Log in to your PrestaShop admin panel
3. Go to: Modules → Module Manager
4. Click „Upload module” in the upper right corner.
5. Select the downloaded ZIP file and click „Upload this module.”
6. When the installation is complete, click "Configure"
7. The module is ready for configuration.

3. Module activation

1. Go to Modules → Module Manager
2. Find the „CC Google Merchant Feed” module”
3. Click „Configure.”
4. Select the „Configuration” tab.”
5. Fill in the basic feed settings
6. Click „Save and Generate XML Feed.”

4. Basic feed configuration

1. In the module configuration, select „Feed language.”
2. Select from the drop-down list of languages for product names and descriptions
3. Click „Save and Generate XML Feed.”

• All products from the selected language are loaded from the store.
• The XML feed is automatically generated and saved.
• The file is available at the URL shown in the „Instructions” tab.”
• Google Merchant Center can immediately download the new feed.

5. Advanced configuration

1. Enter the brand/company name you want to use for products without a manufacturer.
2. If you leave this field blank, the store name from your PrestaShop settings will be used.
3. Brand is required for products without GTIN

1. Enter the prefix for the MPN code (e.g., „MPN-” or „SKU-„).
2. The prefix will be added to the product reference number.
3. If the product has a reference number, the prefix will be applied to it.
4. If there are no references, the prefix will be added to the product ID.

• Product limit – default 0 (no limit). Change to a number such as 1000 if the feed is too large.
• Maximum number of additional images – default 10. Decrease to reduce the size of the feed

6. XML feed structure

 http://example.com
    Product feed for Google Merchant Center  123 Product Name Product Description 

123 Blue T-shirt, size L High-quality cotton T-shirt in blue, size L
  http://example.com/produkt/niebieski-t-shirt http://example.com/images/tshirt-blue-large.jpg
  http://example.com/images/tshirt-blue-1.jpg 99.99 PLN 79.99 PLN
  in stock new 5901234123457 Fashion Brand MPN-123

7. Product filters

1. In the „Categories” section, you will see a list of all categories from the store.
2. Check the boxes next to the categories you want to export.
3. To select multiple categories, hold down CTRL (Cmd on Mac) and click on the categories.
4. Leave unchecked if you want to export all categories.

1. In the „Manufacturers” section, you will see a list of all manufacturers/brands.
2. Check the boxes next to the manufacturers whose products you want to export.
3. To select multiple manufacturers, hold down CTRL (Cmd on Mac) and click.
4. Leave unchecked if you want to export all manufacturers.

1. Enter the minimum quantity of products in stock
2. Products with fewer items will be omitted from the feed.
3. Enter 0 to not filter by quantity (default)
4. Useful for exporting only available products

1. Select the „Only products with promotions” option if you want to export only promotions.
2. Check this box if you want to export all products regardless of promotions.
3. The module automatically adds the sale_price field for discounted products.

8. Integration with Google Merchant Center

1. In the PrestaShop administration panel, go to Modules → Module Manager.
2. Click „Configure” next to the Google Merchant Feed CC module.
3. Go to the „Instructions” tab.”
4. In the „XML feed link” section, you will see the full URL for the feed.
5. Click the „Copy” button to copy the URL to the clipboard.

1. Log in to Google Merchant Center
2. Go to the „Products” → „Channels” section.”
3. Click „New Channel.”
4. Select „Shopping ads” or the appropriate channel type.
5. Enter the name of the channel (e.g., „PrestaShop XML Feed”).
6. In the „Products” section, select „Feed URL.”
7. Paste the copied URL into the feed
8. Click „Next” and complete the channel setup.

1. After adding the feed, Google will automatically download and validate it.
2. Go to „Products” → „Diagnostics”
3. Check if the feed has been successfully indexed
4. If there are errors, the module will show which products have problems.

1. Google Merchant Center automatically downloads the feed sometimes
2. To force an immediate update, click the refresh icon next to the channel.
3. Or configure automatic refresh via CRON (described below)

9. Automatic refresh (CRON)

• Tool for automatically performing tasks on the server
• Allows you to schedule regular activities (every 6 hours, every day, etc.)
• Perfect for refreshing your Google Merchant Center feed
• Requires access to the hosting/server panel

1. In the module configuration, select the „Automatic refresh” option.”
2. If you uncheck this box, the feed will be cached for a specified number of hours.
3. Leave this option selected to regenerate the feed each time it is called.

0 */6 * * * curl -s "http://example.com/modules/cc_ps_google_merchant/feed.xml?token=WYGENEROWANY_TOKEN" > /dev/null 2>&1

• 0 */6 * * * – runs the task every 6 hours on the hour
• curl -s – downloads URLs silently (without messages)
• http://example.com – replace with your store's address
• GENERATED_TOKEN – security token from module configuration
• /dev/null 2>&1 – hides messages and errors

0 */6 * * * wget -q -O - "http://example.com/modules/cc_ps_google_merchant/feed.xml?token=WYGENEROWANY_TOKEN" > /dev/null 2>&1

• 0 * * * * – every hour
• 0 */6 * * * – every 6 hours (recommended)
• 0 0 * * * – every day at midnight
• 0 */12 * * * – every 12 hours

10. Security and tokens

• A unique code randomly generated during module installation
• Required for each feed call by CRON
• Prevents unauthorized persons from refreshing the feed
• Changes with each regeneration

1. In the PrestaShop administration panel, go to Modules → Module Manager.
2. Click „Configure” next to Google Merchant Feed CC.
3. Go to the „Instructions” tab.”
4. In the „Automatic regeneration (CRON)” section, you will see a token.
5. A token is a long string of alphanumeric characters.

http://example.com/modules/cc_ps_google_merchant/feed.xml http://example.com/modules/cc_ps_google_merchant/feed.xml?token=abc123def456ghi789jkl

1. In the „Instructions” tab, click the „Generate new security token” button.”
2. A confirmation window will appear – click OK.
3. A new token will be generated and displayed.
4. The old token will stop working immediately.
5. If you are using CRON, you must update the command with the old token.

11. Logging and debugging

1. Open the feed URL in your web browser.
2. You should see the raw XML code with products.
3. Right-click and select „View page source.”
4. Check if the XML structure is correct
5. Check that all required fields are present for each product.

1. Go to XML Validator
2. Copy the feed content and paste it into the validator.
3. The validator will show whether the XML has the correct syntax.
4. If there are errors, note the line number where the problem is.

1. Go to Google Merchant Center
2. Open the feed channel
3. Go to „Diagnostics”
4. Check „Errors” and „Warnings.”
5. Google will show which products have problems and what is wrong with them.

• If the feed is not generating, check the PHP error logs on the server.
• Search for errors related to the cc_ps_google_merchant module
• Check if the server has write permissions in the module directory.
• Check if PHP has the SimpleXML extension installed.

12. Image sizes

1. In the module configuration, go to „Image size.”
2. Select your preferred size from the drop-down list.
3. Click „Save and Generate XML Feed.”

• Minimum size: 100 x 100 pixels
• Recommended size: 800 x 800 pixels or larger
• Maximum file size: no limit, but Google only downloads the first 10MB
• Formats: JPG, PNG, GIF, BMP, TIFF, ICO, CUR, SVG, WEBP

• The module can add up to 10 additional photos to each product.
• Increases the chances that the product will appear in Google Images search results
• You can disable this option to reduce the size of the feed.
• The „Maximum number of additional images” option allows you to control the number of

13 Troubleshooting

1. Check if the module is active in the Module Manager.
2. Check whether the server has write permissions in the directory. /modules/cc_ps_google_merchant/
3. Log in to the admin panel and try clicking „Save and Generate XML Feed.”
4. Check the server error logs (PHP error.log).
5. Ensure that PHP has the SimpleXML extension installed.
6. Try turning the module off and on again.

1. Check if the products are active in PrestaShop
2. Check if the products have a category assigned to them.
3. If you are using filters, check whether the products meet the filter conditions.
4. Check the minimum quantity in stock – out-of-stock products may be omitted.
5. Open the XML feed in your browser and search for products manually (CTRL+F).

1. Go to Google Merchant Center and open the „Diagnostics” tab.”
2. Read the detailed error message
3. Check which fields are missing – Google requires specific fields
4. The module automatically skips products with missing required data.
5. Ensure that products have: title, description, link, photo, price, availability, GTIN, or brand.

1. Check if the price in PrestaShop is set correctly.
2. Check if the store currency is configured correctly.
3. If there are discounts, the module should select the discounted price.
4. Check that VAT is applied correctly (the price should include VAT).

1. Check if the „Additional images” option is enabled in the configuration.
2. Ensure that products have additional images assigned in PrestaShop.
3. Check that the maximum number of additional images is not set to 0.
4. Open the XML feed and check if there are any g:additional_image_link elements.

1. Check if the CRON task is correctly added in the hosting panel.
2. Check that the URL in the CRON command is correct.
3. Check if the token in the URL is current (it sometimes changes with updates).
4. Try manually entering the URL in your browser to see if it works.
5. Check the CRON logs in the hosting panel – they may contain information about errors.

14 FAQS.