Shopping / Marketing Feeds (Liquid Storefronts)

Domestic Feeds

To prevent price mismatches between the feed and the prices appearing on the storefront due to automatic geo-IP detection and redirection features, you must update the product links in their domestic feeds.

We recommend that you update your domestic product links to include a country parameter to prevent Google feed violations.

Example: For a US merchant: https://www.mystore.com/products/red-shirt?country=US

Failure to do this may result in warnings from Google, after which they will prevent your from submitting marketing feeds.

International feeds

There are 3 main methods you can use to generate an international Marketing feed:

Using supported Shopify apps (recommended).
Manually generating the feed yourself by writing a custom script or program, or creating an Excel sheet.
Using a 3rd party service such as Feedonomics or Channel Advisor.

Supported Shopify apps

The following apps are compatible with Shopify Markets' multi-currency features:

Pricing in the feed

International prices in marketing feeds must be retrieved from the Shopify platform to ensure they are correct.

Due to the complexity of doing this via the APIs, most merchants use a compatible app, which can easily generate the feeds with the correct localized prices.

Alternatively, if you are using a 3rd party vendor such as Feedonomics, they will handle this for you.

Shopify Markets API for product price retrieval:

Retrieving Prices Manually

To generate your own marketing feed you need to generate the prices manually in one of the following ways:

Get the price data via Shopify Product Feeds feature. This is the most efficient and thus preferred method to retrieve all product pricing data.
For more information see Developer Changelog, Product Feeds, and Contextual Product Feeds
Get the price data via Shopify storefront API.
For more information see Query Product Prices.
Get the price data via Shopify Admin API.
- Option 1:
  - Step 1: Get the price ID for each market. For example, CA Price, AU Price etc. See Pricelists API.
  - Step 2: Get the localized price for each product, using the price IDs. See Pricelist API
- Option 2: use the contextualPricing request to retrieve the price for each variant and country combination. For example, replacing ProductVariant and country with each request:
```
{
    productVariant(id:"gid://shopify/ProductVariant/39999460245576") 
    {
        id
        product{id}
        contextualPricing(context:{country:CA}) 
        {
            price{amount, currencyCode}
            compareAtPrice{amount, currencyCode}
        }
    }
}
```
  Note
  These queries can be set up as bulk operations which do not count against rate limits but may take significantly longer to complete.

Country and language considerations

If you have subfolders enabled, you can use the subfolders in your product URLs.

Example: https://mystore.com/en-ca/product/shoes

You can also use the country parameter, regardless of the subfolder settings. If you do have subfolders enabled, this link will redirect the customer to the appropriate subfolder.

Example: https://mystore.com/product/shoes?country=CA

You can use the subfolder and country parameter together, but this is redundant and not recommended.

Example: https://mystore.com/en-ca/product/shoes?country=CA

Note: If the countries do not match, the country parameter takes precedence.

If you have translations for a country’s default language, you can use subfolders to indicate that in the product URL.

Example: https://mystore.com/es-es/product/shoes

Timing

Merchants in PCE countries: You should generate your feeds at 5:00 AM UTC to ensure the daily FX price updates are completed. This configured time may shift to an hour earlier during daylight savings time.
Merchants in CBS countries: You should generate your feed at 1AM UTC to ensure the updated country FX rate is in Shopify.

Shipping rates

To ensure a smooth experience, you'll want to define your shipping rates in the Google Merchant Center (GMC) using the range-based option. These rates should match what you've set up in the Flat Shipping Rates section of your Global-e admin.

Most of our merchants simply copy the shipping rate settings from Global-e into GMC, which helps prevent any mismatches or errors.

If you’re not currently using flat rates, we recommend reaching out to your Customer Success Manager (CSM) to discuss switching to flat rates for the countries you’re marketing to.

Tax rates (US Shipping Only)

If you're shipping to the United States through Global-e, here are some important notes regarding sales tax settings in GMC.

If you're considering building state-specific tax rates into your product feed, please note that this is not something we currently support directly. You’d need to manage those configurations yourself.

Google requires you to enable sales tax settings based on your tax obligations. If this setting is not enabled, Google will assume a 0% tax rate across the board, which could create mismatches at checkout and trigger warnings in your account.

Here are a few options for how you can manage US tax rates in GMC:

Include tax rates per item in your product feed – This is a more complex setup and may require more ongoing maintenance.
Set a state-level rate in GMC:
- Choose a specific rate if your products all fall under the same classification.
- Or use the maximum rate for each state to avoid potential mismatches.
Let Google automatically calculate the tax rate – this is the easiest option, and we’ve seen many brands use it successfully. Google will check that the correct rate is applied when validating your feed.

Please refer to Google’s help page on instructions on how to configure these settings: Set up tax settings (US only) - Google Merchant Center Help.

At Global-e, we use Avalara to calculate sales tax in the US, so all tax rates applied at checkout are based on product classifications and align with state guidelines provided on Avalara’s State Sales Tax Rates page.

Updating product links

The following methods enable you to update your product links to include the targeted international country by leveraging:

Shopify’s Deep Linking feature:
Include a country parameter in your product links (https://help.shopify.com/en/manual/markets/international-domains/directing-customers/deep-links)
Example: https://merchant_url/products/t-shirt?country=DE [Product page for Germany]
Shopify’s subfolder feature. This feature is required if you plan to use the Shopify translation features and requires additional configuration by Global-e.
Example:
- https://merchant_url/en-de/collections/products/t-shirt [Product page for Germany]
- https://merchant_url/en-ca/collections/products/t-shirt [Product page for Canada]
Note
For headless merchants: Any country-specific URL logic for your Shopping feeds must be implemented by your development team, as the above-documented methods only work for Liquid-based storefronts out of the box.

Documentation Portal

Shopping / Marketing Feeds (Liquid Storefronts)

Note

Note