Skip to main content

Documentation Portal

Additional Integration Features

For deploying storefront modifications click here.

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 likely the most efficient method to retrieve all product pricing data.

    For more information see Developer Changelog, Product Feeds, and Unidirectional Product Synchronization

  • 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

Shipping rates should be defined in the Google Merchant Center as "range-based" and should match the configurations in the flat shipping rates section in the Global-e admin.

If you do not have flat rates, discuss with your Customer service management about switching to flat rates.

Tax rates

Taxes are relevant to merchants shipping to the US with Global-e.

Global-e does not currently support building a specific tax rate per state into the product feeds. This needs to be managed independently. Information on setting up taxes can be found here.

Updating product links

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

Block Int'l Orders From The Domestic Checkout

This is a feature related to GEM integration [Click here to continue].

Stock Validation

This feature is related to GEM integration [Click Here to Continue].

Client Side Analytics

This feature is related to GEM integration [Click Here to Continue].

MID Support

U.S. Customs requires the Manufacturer's Identification Code for certain shipments to the United States.

What is Manufacturer’s Identification

Manufacturer's Identification (MID) includes details of the manufacturer of the goods which is required in some cases by the US customs. MID includes the full business name and postal address of the manufacturing supplier as well as a specific code based on the manufacturer's name and country.

MID is required for:

  • Any order shipped to the USA, with a declarative value to customs above $800, including at least one product manufactured in China.

  • Any shipment to the USA with a declarative value to customs higher than $2,500 (regardless of the Country Of Origin of the products).

Configuration

Configure the following MID fields:

  • MID Code: A unique identifier generated from the manufacturer's name and location.

  • MID Address: The full postal address of the manufacturing supplier.

  • MID Name: The complete business name of the manufacturing supplier.

To generate an MID Code

The Global-e Crossborder app gets the MID information from the Product Meta fields in the Products section.

If the required data is not already available in your system or cannot be obtained from your manufacturer(s), you can generate the MID code by following the steps below.

  1. Collect Supplier Information: Ensure your manufacturing supplier has provided their complete business name and postal address. This information is essential for defining the MID code.

  2. Generate the MID Code

    1. Identify the two-letter ISO country code for the supplier’s country (e.g., GB for the United Kingdom, NL for the Netherlands, DE for Germany).

    2. Use the first three letters of the supplier's first and second names (if applicable).

    3. Extract the highest numerical digits (up to four) from the address line.

    4. Use the first three letters of the supplier’s city name.

    Example:

    Supplier: Ozrock, 92 Alice Springs Road, Melbourne, Victoria, Australia, 3001

    MID Code: AUOZR92MEL

MID Address and MID Name configuration

No special formatting is required for the MID Address and MID Name fields. These fields should be filled exactly as provided by the supplier's data.

Example:

  • MID Address: 92 Alice Springs Road, Melbourne, Victoria, Australia, 3001

  • MID Name: Ozrock

Adding MID to Shopify

For Global-e to provide the MID information to the carrier and display it on the commercial invoice, this data must be available in Shopify and transferred to Global-e using the following configuration.

  1. Create the relevant Shopify metafields.

    • Go to Settings > Custom Data > Products > Add definition.

      For more information see the Shopify Metafield Guide.

      Note: If the manufacturer of your goods may vary between variants of the same product, the metafields should be created as "variant metafields" in Shopify, rather than as "product metafields."

      7205691c-e735-4ae1-b1bd-8b703fe1fab4.png

  2. Update each product/variant’s metafields with specific MID data.

    This can either be edited in bulk, or added to each product/variant individually.

    Note that if you have various manufacturers with different IDs, the metafields should be set individually for each product/variant, to reflect the manufacturer they originate from.

  3. Provide Global-e with the associated keys to enable the final configuration required for presenting the MID data on commercial invoices.

    The associated keys can be found on each metafield page in Shopify in the Namespace and Key field.

    See the example below in which the key is MID Address.

    f3251305-6341-4344-b30b-6a93ef5b903c.png