solutions for e-commerce

13 years of business 2561 reviews 4.9 average rating
User guide

What is Google Merchant Promotions

The Google Merchant Promotions extension allows you to enhance your Product Listing Ads with special offers by displaying your promotions directly in Google Shopping.

Consumers rely on Google to help them find the perfect product from the right store and at the best value. Merchant promotions give you the opportunity to highlight the benefit of purchasing from your store at the moment consumers are deciding where to shop.

As an example, Venus increased their click-through rate by 7% and decreased their cost-per-click by 11%.

In order to participate in the Google Merchant Promotions program, you need to follow 5 steps:

  1. Fill out the Merchant Promotions interest form. The Google team will review your participation request within 1-2 weeks.
  2. Have an active products feed.
  3. Review Google's Program Policies and Editorial Guidelines
  4. Create a promotions feed. Visit the Merchant Promotions feed specification to learn more about the information you can submit in the feed.
  5. Review Google's approval process

The Google Merchant Promotions extension for Magento allows you to create your promotions feeds easily and within a few minutes.

Our Google Merchant Promotions extension also includes Simple Google Shopping. To know more about that module, check out our documentation.

Configure the Google Merchant Promotions extension for Magento

Configuring the Google Merchant Promotions extension will take you a few minutes before being ready to use. We have established 3 easy steps to follow.

STEP 1: Configure the Google Merchant Promotions extension in a general way


You can first in the Settings tab from:
SystemConfigWyomindGoogle Merchant Promotions

You'll be able to define your own settings:

  • Logo URL
    You can modify the logo URL or leave that field blank. By default, it uses the logo you've defined in your Magento configuration.
  • Data feed URL prefix
    You can define a prefix.
  • Data feed URL suffix
    You can also define a suffix. By default, the data feed URL suffix is "_promotions". So all your promotion files will end with:
  • Debug mode
    You can enable the Debug mode. The promotion data feed will then display additional data that will help you to easily debug your feed. We advise you to set that option to NO once your tests are passed.

STEP 2: Manage the promotions

Configure the settings of your shopping cart price rules

You can create a new rule or choose one in:
PromotionsShopping Cart Price Rules

In the Rule Information tab, you can specify if you want to upload the promotion to Google Merchant. To do so, set Upload to Google Merchant to YES.

Then you need to check that your promotion complies with the requirements of Google Merchant Promotions by clicking on Google Promotions requirements.

After that, click on Save.

You can have a quick look at the promotions you've decided to upload to Google Merchant in:
PromotionsShopping Cart Price Rules

Check out the value in the last column named Upload to Google Merchant for each promotion.

Configure your data feed

You should find a preconfigured template named GoogleShopping_feed.xml, if you go to:
CatalogSimple Google Shopping

To retrieve the product promotion ids in the data feed, you need to add the below promotion attribute to the XML pattern:


This attribute is used to link your products to the promotions. You can add it to any feed you want. 

To check the promotions ids that the attribute retrieves, click on PREVIEW. In the below screenshot, the attribute found one promotion with id 42, for the first product of our feed.

Note that the promotion ID won't be displayed in the data feed when item in cart conditions are added as there is no contextual data such as customer, cart or item in cart when exporting a product data feed.

A product can have only one promotion assigned. In the case where there are two promotions for one product, the promotion displayed will be defined according to the priority.

Check our documentation to know more about the Simple Google Shopping extension.

STEP 3: Manage the feeds

You can see two links from: 
CatalogSimple Google Shopping

  • Products file link
  • Promotions file link

Products feed

In the Products file link column, is the URL of your products data feed. If you click on that link, you should see all your products as on the screenshot below.

Promotions feed

In the Promotions file link column, is the URL of your promotions. Here again, if you click on that link, you should see all the promotions you've decided to upload to Google Merchant Promotions. 1108924399-GMP_url_promos.jpg

This is displayed only when the Debug mode is enabled from the Settings tab in:
SystemConfigurationWyomindGoogle Merchant Promotions

Each promotion retrieves the information that Google asks such as the product applicability, the promotion display dates.

Generate your feed

When clicking on Generate, you get a notification to specify that the data feed has been correctly generated. You also get two URLs:

  • The products file
  • The promotion file

You will need both URLs to upload your feeds for the first time to your Google Merchant account.

Have a look at our tutorial to submit your product feed to Google Merchant.

Display your promotions in Google Shopping with Google Merchant Promotions!

Easily display your promotions in Google Shopping

Export your promotion files to Google Merchant in one go

Be totally compliant with Google's requirements

  • Use the sample template provided with the extension
  • Use Simple Google Shopping included with Google Merchant Promotions

Automatically and regularly send your updated data feed to Google

  • Use the scheduled tasks to periodically generate your data feed
  • Check your data feed generation (number of items, time, and resource)
  • NEW! Make sure your data feed is correctly generated thanks to the generation status
Freqently Asked Questions
Pre-sales informations

This extension works with Magento Community Edition and also Magento Enterprise Edition. To know if Google Merchant Promotions is compatible with your Magento version, please check the Compatibility tab. 

License and domains

We offer our customers who want to migrate their Magento 1 license to a Magento 2 license, the transfer at a reduced price. 

You have the possibility to migrate your license directly from your Wyomind account in:
My accountLicenses & Downloads

Click on migrate to magento 2  in front of the extension and the domain you want to transfer. 

Confirm you want to migrate your license to a Magento 2 license by clicking on Confirm and checkout .

An invoice will be automatically added to your account from: 
My accountInvoices


The price of the transfer is equivalent to a 30% reduction compared to the price of the regular Magento 2 license.

You can proceed to the payment by clicking on PP .

Once the payment is done, you can go back to: 
My accountLicenses & Downloads

There you will be able to download and install your license for Magento 2. 

Note that your license for Magento 1 will remain active indefinitely in your Wyomind account in order for you to migrate with peace.

A license is valid for an unlimited period of time on one single Magento installation.

If you use more than one Magento installation, you will have to buy a separate license for each one.

If you run several domains on the same Magento installation, you will need only one license for all of them.

Although your license doesn’t have a limited period of validity, your support period does. By purchasing an extension, you’ll be granted a 6-month support period for free. Passed this period, you will have to renew your Support plan (see FAQ: How to extend my support period?).

You can pre-register your live domain to your license in advance.

Thanks to this option, you'll be able to get the extension ready to use on your domain before it goes live.

To pre-register your production domain: 

  1. Go to:
    mY accountLicenses & DOwnloads
  2. Click on  next to the extension you want your domain to pre-register on.
  3. Click on the link at the bottom of the page saying:
    Do you want to pre-register your domain in order to be ready to go live?
  4. Finally, enter your domain name and click on pre-register now .
Attention, this doesn't mean your license is activated. You'll still have to activate it on your new domain when the extension is installed. 

One license is valid for an unlimited period of time on one Magento installation only.  

It is possible, however, to extend or transfer your license in 2 cases: 

  • If you'd like to add your testing environments to your license.
    In this case, it is possible to extend your license to an unlimited number of domains for free.
    For example or
  • If you want to transfer your license to another live domain.
    In that case, the support period for your license must still be active.

To be able to use Google Merchant Promotions on both your production and testing environments, follow the instructions below:

  1. Download Google Merchant Promotions.
    (see FAQ: Extensions download)
  2. Install Google Merchant Promotions on your production environment.
    (see FAQ: Extensions installation)
  3. Activate the license.
    (see FAQ: Extensions activation).
  4. From your Magento admin panel, enter your current Activation Key in:
  5. Save your configuration.

Now that you can use Google Merchant Promotions on your production environment, repeat the same steps as above on your testing environments.

The only difference this time: a notification will appear in your Magento admin

You will be given a choice between:

  1. buy a new license now
  2. add this domain to my license

Click on Add this domain to my license.

A transfer request will then be sent to our team within an hour.

Once the request is taken care of, you will receive a confirmation email.

If your transfer request is accepted, you can use Google Merchant Promotions on both environments at the same time.

The order in which you activate your license on your domains does not matter.
You can start with your staging/dev/local environment or with your live domain, the process will be the same.
Modules versioning and download

In order to download Google Merchant Promotions, log into your Wyomind account:

    1. Go to:
      my accountLicenses & downloads 
    2. Click on the  icon next to Google Merchant Promotions.

      A new window opens.

    3. Choose the version of Google Merchant Promotions.
      You will be able to choose the most recent version of Google Merchant Promotions (for both Magento 1 and Magento 2).
    4. Click on  .

Your download can start.

When purchasing an extension from, you benefit from a lifetime upgrade. You can at any time download the latest version of the extension directly from your account. 

To upgrade Google Merchant Promotions, follow the steps below:

  1. Go to:
    my accountLicenses & Downloads
  2. Click on  next to Google Merchant Promotions.
  3. Choose the latest version of Google Merchant Promotions (for Magento 1 and Magento 2).
  4. Click on download .
  5. Install the new version of Google Merchant Promotions to update your Magento admin. 

Modules Installation/Uninstallation

To uninstall Google Merchant Promotions, go on its zip folder and open it.

You will find a shell file (such as: that you must execute on both your server and Magento root directory.

Once the uninstallation is over, refresh your cache and enable the compiler back again (if you use it).

Before installing Google Merchant Promotions, you’ll have to:

  • Backup your Magento installation in:
    system  tools   backups
  • Disable the compiler in your Magento admin panel if it’s not already disabled:
    system  tools   COMPILATIONS
  • Refresh your cache in:
    systemselect cache typeactionsrefreshsubmit

Now you can install Google Merchant Promotions:

  1. Download Google Merchant Promotions (zip file) from:
    my account my downloads
    Refer to FAQ here: Extensions download
  2. Once Google Merchant Promotions is downloaded, open the folder and unzip it.
  3. Copy the content of the unzip folder and paste all files and directories in your Magento root directory (the folder content can vary according to the extension but it generally includes app, lib and skin folders).

  4. Once your installation is complete, don't forget to enable the compiler back (if it was already enabled before the installation) and run compilation process.
  5. Refresh your cache, logout from your admin panel and log back in right after.

Next step is to activate your license, to do so, click here: Extension activation

Modules activation

Once Google Merchant Promotions is installed, you have to activate the license: 

  1. Go to your Magento admin panel. A message pops up at the top of the page.

    If the message doesn't appear then you must check that:

    Wyomind's License Manager has not been removed from your installation.
    Wyomind's License Manager is enabled in: app/etc/modules/Wyomind_Licensemanager.xml
    The HTML output for Wyomind_Licensemanager and/or Adminhtml_Notification are not disabled in your system under: system   configuration  advanced advanced

  2. Copy your activation key.

    You can find your activation key in 2 different places:
    - In the confirmation email that you received after purchasing Google Merchant Promotions
    - In your Wyomind account:MY ACcount My downloads, select Google Merchant Promotions and click on  . A new page opens where you'll find your activation key (see below).
  3. In your Magento admin go to:
    SysteMConfigurationWyomindYour extension

    Paste the activation key in the Activation Key field and choose between the automatic (yes) or the manual (no) activation method:
    - By choosing Yes, the connection to Wyomind license server will be automatic. 
    - By choosing No, you will have to log on to Wyomind license server yourself.

  4. Save the configuration.
  5. Clear your caches. 
  6. A message appears at the top of your admin panel: Activate it now!  Click on that link.

  7. Copy and paste the license code in the License code field from your admin or simply click on Activate now! 
  8. Finally, refresh your cache, log out and log back in straight after, to complete the installation.

To activate the license of an extension that includes other modules, you’ll have to repeat the steps described above for each extension, using the corresponding activation keys (each module has its own activation key).

Modules use

When exporting a product data feed there is no contextual data such as customer, cart or item in cart. As a consequence no promotion can be applied to your data feed with these conditions.

You can easily debug your promotion data feed using the Debug mode.

For that, define the Debug mode option on Yes from:
SystemConfigurationWyomindGoogle Merchant Promotions

This will allow you to see additional data and debugging your promotion data feed when clicking on the Promotions file link:
Catalog Simple Google Shopping


If your site crashes and gives this error message after uploading all files to the correct folders:

Fatal error: Class 'Wyomind_Notificationmanager_Model_Resource_Setup' not found in includes/src/Mage_Core_Model_Resource_Setup.php on line 234

It probably comes from installing an extension while the compiler is still enabled.

Important note:

  • If the compilation is enabled on your website, disable it first before installing any extension from: 
    After installation re-run the compilation process and re-enable the compiler.
  • Before installing any extension, it's advisable to backup your Magento installation.

Here is how to disable the Magento compiler:

  1. Edit the following file: includes/config.php and add a # before the 2 following lines:

    to get:

  2. Then go back to your website admin and re-run the compilation process.

If you're getting a white page using the extension, you should enable the error reporting in order to display the error. You can do that from index.php.

Most of the time log-out/log-in may solve this issue.

How do cron tasks work:

  • cron.php is launched regularly from your server side (every 5 minutes most of the time).
  • The cron task for Google Merchant Promotions is targeted and evaluates if a data feed or a profile needs to be refreshed (depending on the timestamp stored in the database and on the schedule table for this specific profile).
  • If the above condition matches, then the data feed and the profile is re-generated.

Be sure that you have correctly configured a scheduled task from the server side (cpanel) targeting the cron.php file in your Magento installation.

The extension includes reporting and debug tools for the scheduled tasks in:
systemconfigurationWyomindGoogle Merchant Promotions

We also strongly advice to install the AOE Scheduler that will help you to monitor the Magento cron tasks.

If when saving your data feed configuration, you get:

Forbidden, You don't have permission to access /.../ on this server.

This is probably something regarding the hosting company that doesn't allow to post XML in the form.

The mod_security (security module) includes rules that stop all post/get requests including code.

In order to fix that issue, you should get in touch with your hosting company so that they can add some exceptions to the security rules.

Magento 1 / Openmage Compatibility

Magento 1 / Openmage®

  • 1.1.3
  • 1.1.4
  • 1.1.5
  • 1.1.6
  • 1.1.7
  • 1.1.8
  • 1.2.0
  • 1.2.1
  • 1.3.0
  • 1.3.1
  • 1.3.2
  • 1.3.3
  • 1.4.0
  • 1.4.1
  • 1.4.2
  • 1.5.0
  • 1.5.1
  • 1.6.0
  • 1.6.1
  • 1.6.2
  • 1.7.0
  • 1.8.0
  • 1.8.1
  • 1.9.0
  • 1.9.1
  • 1.9.2
  • 1.9.3
  • 1.9.4
  • 1.10.0
  • 1.10.1
  • 1.11.0
  • 1.11.1
  • 1.11.2
  • 1.12.0
  • 1.13.0
  • 1.13.1
  • 1.14.0
  • 1.14.1
  • 1.14.2
  • 1.14.3
  • 1.14.4

Magento 1 / Openmage® Enterprise (deprecated)

  • 1.1.3
  • 1.1.4
  • 1.1.5
  • 1.1.6
  • 1.1.7
  • 1.1.8
  • 1.2.0
  • 1.2.1
  • 1.3.0
  • 1.3.1
  • 1.3.2
  • 1.3.3
  • 1.4.0
  • 1.4.1
  • 1.4.2
  • 1.5.0
  • 1.5.1
  • 1.6.0
  • 1.6.1
  • 1.6.2
  • 1.7.0
  • 1.8.0
  • 1.8.1
  • 1.9.0
  • 1.9.1
  • 1.9.2
  • 1.9.3
  • 1.9.4
  • 1.10.0
  • 1.10.1
  • 1.11.0
  • 1.11.1
  • 1.11.2
  • 1.12.0
  • 1.13.0
  • 1.13.1
  • 1.14.0
  • 1.14.1
  • 1.14.2
  • 1.14.3
  • 1.14.4
User's reviews
Log into your account to leave your review and get up to 3 months of free Support & Upgrade.

6th June 2022

Saves so much time

This has saved us loads of time, especially during busy periods like black friday! Just add the code to the simple google shopping feed, toggle it on for the promotional rule and it’ll get picked up by google no problems!

Steve - Merchant - User for more than 9 years |Magento 1|Magento 2

26th May 2021

Makes Managing Google Shopping Feeds Nice and Easy!

The Simple Google Shopping extensions takes the hassle out of creating feed files. It's easy to navigate, customise, de-bug and use. The capability to set rules on what to pull into the feed, along with the category mapping against Google's taxonomy are fab! Plus support has also always been great!

Mel - Merchant - User for more than 7 years |Magento 1

2nd March 2019

Fanastic module!

Very nice module. It´s very simple to use and clear.

esp - User for more than 7 years |Magento 1|Magento 2

2nd April 2018

Easy to use add-on

The Simple Google Shopping and the Google Promotions Add-on are easy to use and configure. I have only had some problem with the time taken to generate the feed, for large websites. Trying to optimize this. Support is excellent and very responsive which is a delight.

10th November 2017

Superb support

On the occasions we have needed support from Wyomind our support requests have been answered professionally, and very, very quickly. Following up has been even faster! No frustration of hanging around for numerous days or weeks for a response like we have experienced from some other companies. They understand the importance of quick customer support required to enable smooth running of your site. Probably one of the best extension companies for its customer support, its great to know they are there if needed. As per other reviews you can see that this level of support is not a one off. Well done guys. Fantastic and many thanks again.

ukdig - User for more than 7 years |Magento 1|Magento 2

10th October 2017

Takes the hassle out of google promotions

Takes the hassle out of making a feed file of your latest promotional codes. Also really easy to tell Google about product specific promotions when used with DataFeed Manager. Have it set up to update every day.

7th April 2017

Great Extension

Have used this extension for several years now and find it invaluable when sending our shopping feeds to both google and bing. It's very quick to run also and we have managed to customize this feed as well. Had an query recently and support got back to us quickly.

4th September 2015

Excellent Extensions and Support That Is Second To None.

We've purchased 3 extensions from Wyomind, all of which suited our needs perfectly.
Installation was a breeze and all perform flawlessly. We've since upgraded the extensions which went seamlessly.
The Support from Wyomind however.....OUT OF THIS WORLD.
Unlike any we have experienced before. Questions answered within minutes not days and any issues solved in record time.
We would have no hesitation is recommending Wyomind and their extensions to anyone. When something works this well, I have no problems in paying for this level of service and quality.
Well done guys, customer for life.


8th June 2015

Simple to Use

After failing with a free PLA solution I researched my options and decided on the Merchant Promotions module to stand out in the crowd. Slight issue but Paul was able to fix immediately. Looks like the issue was implemented into the next round of Simple Google Shopping updates.


Initial release for the master version

Initial release for the legacy version

Bug fix

  • Auto-generation setting is not saved properly
  • In cart prices rules, the coupons can be generated again


  • Update of the promotions file specifications :
    • add <g:percent_off> tag
    • update <g:free_shippping> value


  • Update of the promotions file specifications

New features:

  • Compatibility with Simple Google Shopping 9.0.0
  • First Release
Demo store

Stay tuned and get a coupon code of 10% off any purchase while creating your account!

Subscribe now for updates, promotions and products launch twice a month at most.

Please indicate a valid email