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. All domestic product links should append the country parameter with the 2-letter country code of their domestic market. 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. Feedonomics will have you create a custom app and share the API key with them. This will allow them to retrieve the international prices directly from the Shopify contextualized price API 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} } } }
  These queries can be set up as bulk operations which do not count against rate limits but may take significantly longer to complete.

Updating product links The following methods allow 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](http:// 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]
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. For more information, see Headless section under Shopping / Marketing Feeds.Headless

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