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.
Recommended approach
Google Merchant Centre supports automatic fetching at a minimum frequency of every 24 hours. To configure this:
- In Google Merchant Centre, go to Products > Feeds
- Select your feed and go to Feed settings
- 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_dateDescription: 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_datetimeXML Feed:
2016-02-24T13:00-0800/2016-02-29T15:30-0800Real Example:
2025-10-31T14:00:00+0000/2025-12-31T14:00:00+0000
Loyalty points
Attribute:
loyalty_pointsDescription: 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_bundleDescription: Indicates whether the product is a bundle of multiple items.
Implementation: Automatically set based on product configuration in StoreConnect.
Values:
trueif product is a bundle,falseif notXML 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.