View the Google Merchant feed

This integration eliminates the need for manual configuration. StoreConnect also automatically generates a Facebook Merchant Catalog Data Feed.

About the merchant feed XML file

The Google Merchant Feed is a file listing all products to be uploaded and kept synchronised with a Google Merchant Center account.

StoreConnect automatically generates and updates this file daily. You can view it at [yourstoreURL]/merchant_feed/google.xml.

Tip: Download the file in your browser's incognito mode to ensure you get the current version, and not an older cached version.

Feed update schedule and syncing with Google Merchant centre

The Google Merchant Feed regenerates automatically every 6 hours. However, the feed does not run on a fixed daily schedule — the cycle begins 1 hour after the application is deployed, then repeats every 6 hours from that point. Because deployments and server restarts can occur at any time, the exact update times are not predictable and will shift whenever a restart occurs.

This means it is not possible to align Google Merchant Centre's fetch schedule to a specific time of day.

Google Merchant Centre supports automatic fetching at a minimum frequency of every 24 hours. To configure this:

  1. In Google Merchant Centre, go to Products > Feeds
  2. Select your feed and go to Feed settings
  3. Under Fetch schedule, set the frequency to Every 24 hours

Since the feed regenerates every 6 hours on our end, a daily fetch from Google will always pick up a recent version of the feed. If you need Google to reflect a change sooner, you can manually trigger a fetch at any time from within Google Merchant Centre.

Product requirements: to appear in the merchant feed

  • Set to Active
  • Has an Available on date in the past
  • Discontinued at date (if applicable), is in the future
  • Merchant Feed option is selected
  • The price is greater than $0
  • Has a meta title
  • Has at least one product image

Once all requirements have been met, the product will appear in the xml file on your store site per the feed update schedule, ensuring your products are accurately represented on Google Shopping, and enhancing visibility and potential sales.

How the merchant feed represents your product

  • Variant products generate a productGroupID, allowing Google Merchant Center to correctly group variants under a single product
  • Up to 10 product images per product are included in the feed, in line with Google Merchant Center specifications
  • The feed outputs the original product image quality where available, rather than scaled-down versions
  • Product titles and brand values are sourced from storefront display values rather than internal system names
  • Discontinued products do not have forced “Discontinued” text added to product names in the feed
  • Shipping country values are derived from the store and shipping configuration
  • Shipping dimensions and units are validated before being included in the feed
  • Products with missing optional data (for example shipping dimensions or secondary images) are skipped or partially rendered without preventing the feed from generating

Additional attributes for enhanced product listings

StoreConnect supports additional merchant feed fields, to provide more detailed information to potential customers. These include the following.

Shipping options

  • Attribute: shipping
  • Description: Specifies the shipping options available for a product, including costs, regions, and estimated delivery times.
  • Implementation: Pulled from StoreConnect's shipping configuration. If no specific shipping option is available, the attribute is omitted.
  • XML Feed:

  AU
  NSW
  StarTrack Satchel
  13.20 AUD

0.2 kg
21 cm
15 cm
4 cm

Instalment payment plans

  • Attribute: installment
  • Description: Specifies installment payment plans available for products.
  • Implementation: Data is sourced from StoreConnect's installment fields. If no installment plans exist, this attribute is excluded.
  • XML Feed:

  6

    50
    EUR

  200 EUR

Sale price effective date

  • Attribute: sale_price_effective_date

  • Description: Defines the time range during which a sale price is active.

  • Implementation: Pulled from the pricing module where sale prices and their start/end dates are configured. Omitted if no sale period is set.

  • Format: ISO 8601 date range format: start_datetime/end_datetime

  • XML Feed:

    2016-02-24T13:00-0800/2016-02-29T15:30-0800
    
  • Real Example:

    2025-10-31T14:00:00+0000/2025-12-31T14:00:00+0000
    

Loyalty points

  • Attribute: loyalty_points

  • Description: Specifies loyalty points customers earn from purchasing a product, along with member-specific pricing and shipping benefits.

  • Implementation: Mapped from StoreConnect's loyalty program fields. Excluded if not applicable. Multiple loyalty program entries can exist for different tiers (e.g., silver, gold).

  • XML Feed:

    
      my_loyalty_program
      silver
      10.00 USD
      10
      2017-05-11T00:01:59-0800/2017-06-21T22:13:59-0800
    
    
    
      my_loyalty_program
      gold
      9.00 USD
      20
      2017-05-11T00:01:59-0800/2017-06-21T22:13:59-0800
      loyalty_shipping_gold
    

Product bundles

  • Attribute: is_bundle

  • Description: Indicates whether the product is a bundle of multiple items.

  • Implementation: Automatically set based on product configuration in StoreConnect.

  • Values: true if product is a bundle, false if not

  • XML Feed:

    false
    

By incorporating these additional attributes, StoreConnect ensures compliance with Google Merchant Center requirements and enhances the richness of your product listings.

Access and verify your feed

Your Google Merchant Feed is accessible at: [https://yourstore.com/merchant_feed/google.xml](https://yourstore.com/merchant_feed/google.xml)

Each store has its own unique feed file. To ensure accuracy, always download the file in a private/incognito browsing window to bypass cached versions. To show shipping, it must have Shipping options configured.

Example XML output

Basic product output.




      01t2v00000CrI76AAF
      Aloe Oil Free Foundation (Gold 2)

      AU-Apr 26-27 '23 Sale Products Ambassador
      https://proma.global/products/aloe-oil-free-foundation-gold-2-30ml-41e8
      https://res.cloudinary.com/hpf2bgvwe/image/upload/c_fit,f_auto,h_480,w_480/v1/media/00d2v000003qbb7eao/aloe-oilfree-foundationv2.jpg?_a=BACCg+GT
      new
      in stock
      42.00 AUD

      12064A

      false

        AU
        ACT
        StarTrack Satchel
        13.20 AUD


        AU
        NSW
        StarTrack Satchel
        13.20 AUD

      0.066 kg
      13 cm
      5 cm
      3 cm

Example with optional fields




      01t2u0000003ubFBAQ
      Our Amazing Product
      Electronics > Video > Televisions > Flat Panel Televisions
      Consumer Electronics > TVs > Flat Panel TVs
      https://store.example.com/products/your-product-slug
      https://image-link.example.com/example.png
      new
      in stock
      799.95 AUD
      699.95 AUD
      2016-02-24T13:00-0800/2016-02-29T15:30-0800
      Product Brand
      PRODUCT-CODE
      If you're looking for an >em<LED TV</em>, this is the one to buy. It's an impressive model that offers great picture quality & performance, as well as a ton of extra features. It looks fairly sleek & will not stick out when wall-mounted.
      false

        AU
        Regular Australia Post Shipping
        10.00 AUD

      0.2 kg
      21 cm
      15 cm
      4 cm


        6

          50
          EUR

        200 EUR



        my_loyalty_program
        silver
        10.00 USD
        10
        2024-04-01T00:01:59-0800/2024-04-30T22:13:59-0800



        my_loyalty_program
        gold
        9.00 USD
        20
        2024-04-01T00:01:59-0800/2024-04-30T22:13:59-0800
        loyalty_shipping_gold

Source information for attribute values

Google Field StoreConnect Field
g:id The product's Salesforce ID
g:title The product's Display Name, or if blank, the product's Name
g:google_product_category Generated from the Google Product Category fields on product categories for this product
g:product_type Generated from the product categories for this product
g:link Generated from your Store's Domain name plus the product sub path and the product's Slug field
g:image_link The public link to the first Media item, sorted by the Product Media Position
g:condition The product's Condition value
g:availability In Stock or Out of Stock depending on stock level. Always In Stock unless Track Inventory is checked
g:price The product's Price Book Entry List Price for the store's default Price Book and Store Currency
g:sale_price The product's Price Book Entry Sale Price for the store's default Price Book and Store Currency
g:sale_price_effective_date Pulled from StoreConnect's pricing module where sale prices and their start/end dates are configured. ISO 8601 format date range. Omitted if no sale period is set
g:brand The name of the associated Brand on the product
g:mpn The product's Supplier's Internal Code
g:description The content of the product's Search Description field, if present, otherwise the Summary Markdown field. This field is first parsed through a liquid filter and then converted from Markdown to HTML (keeping any HTML in there). The field then has any tag that is not supported by Google Merchant feed, listed here, removed and line breaks inserted as appropriate. If the Search Description and Summary fields on the product are blank, StoreConnect will attempt to put the brand, name and meta description into this field separated by hyphens.
g:is_bundle Product bundle configuration. true if product is a bundle, false if not
g:shipping Any shipping options available for this product, there can be more than one shipping option and related attributes if your store offers that
g:shipping:g:country The country code that this shipping set relates to, is taken from the Zone Country of the configured shipping and sent as a 2 letter country code
g:shipping:g:region Shipping zone region/state. State or region code (e.g., NSW, VIC, ACT)
g:shipping:g:service The shipping name
g:shipping:g:price The price of shipping with the Store's currency code
g:shipping_weight The Shipping Weight of the product with it's Shipping Weight Unit
g:shipping_length The Shipping Length of the product with it's Shipping Dimensions Unit
g:shipping_width The Shipping Width of the product with it's Shipping Dimensions Unit
g:shipping_height The Shipping Height of the product with it's Shipping Dimensions Unit
g:installment Installment payment details from StoreConnect's installment fields. Excluded if not applicable
g:installment > g:months Number of months for payment plan from installment configuration
g:installment > g:amount > g:value Payment amount per period from installment configuration
g:installment > g:amount > g:currency Currency code for installment from store currency
g:installment > g:downpayment Down payment amount with currency from installment configuration
g:loyalty_program Loyalty program details from StoreConnect's loyalty program fields. Excluded if not applicable. Multiple loyalty program entries can exist for different tiers
g:loyalty_program > g:program_label Program identifier from loyalty program settings
g:loyalty_program > g:tier_label Member tier (e.g., silver, gold) from loyalty tier settings
g:loyalty_program > g:price Member-specific price from loyalty tier pricing
g:loyalty_program > g:loyalty_points Points earned from purchase from loyalty program settings
g:loyalty_program > g:member_price_effective_date Date range for member pricing from loyalty pricing module
g:loyalty_program > g:shipping_label Special shipping option for loyalty members from loyalty shipping settings

Troubleshoot merchant feed issues

  • A product does not appear in the feed - Check that the product meets the minimum product requirements for appearing (see above)
  • Data does not seem to be up to date - Check that you have the correct feed file by ensuring you use incognito mode for accessing the file.