Skip to content
Log in

View the Google Merchant feed

On this page

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 synchronized 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:

```liquid

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:

```liquid

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:

    liquid 2016-02-24T13:00-0800/2016-02-29T15:30-0800

  • Real Example:

    liquid 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:

    ```liquid

    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:

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

```liquid

  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

```liquid

  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.

Related articles

Documentation Search engine optimization Documentation About the StoreConnect console Documentation Accounts management features

Was this article helpful?

Was this article helpful?