The Global-e modifier connects to your Global-e account and returns the converted price for each product in the destination countries you sell to. Use it to build country-specific feeds that match the prices shoppers actually see on your site.
When to use this
Reach for this modifier when you sell internationally through Global-e and need your shopping feeds (Google, Meta, etc.) to show the local currency and price for each target country. Google's stable landing page policy requires the price in the feed to match the price on the landing page, so feeding GBP to a US shopper who lands on a USD page will get items disapproved.
It works with any storefront: Shopify (legacy), BigCommerce, Magento, WooCommerce, PrestaShop, Salesforce Commerce Cloud, and custom builds. For Shopify Markets (the non-legacy integration), currencies can be imported directly at the source level instead of through this modifier.
How to configure
The modifier needs your Global-e credentials plus a few feed fields it can read prices from.
- Credential - select a saved Global-e credential (Merchant Id and Merchant GUID). Add a new one from the credential picker if you have not stored it yet.
- Vat Rate - the VAT rate already included in your store prices, as a percentage. Defaults to 20.
- Product Id - the feed field that holds the product identifier sent to Global-e, typically item_id.
- Price - the feed field with the original store price, typically price.
- Was Price - optional. The feed field with the pre-sale price, typically was_price. Pass it through if you want sale prices localised too.
- Store main country - the country your store prices are in (for example GB if your prices are in GBP including UK VAT). This sets the source currency Global-e converts from.
- Countries - the destination countries you want prices for. Pick one or many (US, DE, FR, and so on).
- Error threshold - the minimum percentage of items that must come back with a valid price for the feed run to succeed. Defaults to 85%. Lower it if you knowingly have products Global-e does not price.
Output
The modifier returns a JSON array of localised price entries for the product, one per destination country. Feed that into the rest of your modifier chain to split it out per country feed, or pipe it into price and currency fields directly.
Example
Configured as in the screenshot above:
- Store main country: GB (so source currency is GBP)
- VAT rate: 20
- Product Id: item_id
- Price: price
- Was Price: was_price
- Countries: US, DE
For a product where item_id = SKU-1234 and price = 50.00 GBP including 20% VAT, Global-e returns the converted prices for the United States and Germany. The modifier output looks like:
[
{"country":"US","currency":"USD","price":"63.50"},
{"country":"DE","currency":"EUR","price":"58.20"}
]Exact figures depend on your Global-e exchange rates, duty settings, and country-specific VAT.
Shopify Markets: import currencies at source level
If you run Shopify Markets (the modern integration, not legacy), you do not need this modifier. Pick the destination countries directly on the source settings and Shopify supplies the localised prices.
Tag your product URLs so the right currency loads
Once prices are in the feed, the landing page must display the same currency. Add a URL tagger modifier to append the right query parameters.
Shopify Markets uses a single country parameter:
Input https://www.example.com/item/id/1234 becomes https://www.example.com/item/id/1234?country=GB.
Other stores and legacy Shopify integrations use glCountry for the country and glCurrency for the currency:
Input https://www.example.com/item/id/1234 becomes https://www.example.com/item/id/1234?glCountry=GB&glCurrency=GBP.
Need a hand?
If you would rather have us wire up the credentials, country splits, and URL tagging for you, get in touch with the Feedoptimise team and we will set it up.