WooCommerce - Global-e Docs

Part of the EU Consumer Guarantee (Notice & GARAN) - Platform Setup Guides.

One-time setup

In Products → Attributes, create an attribute to hold the GARAN URL. Use slug garan-image-url (the name can be something like GARAN Image URL).
Go to WooCommerce → Settings → Integrations → Global-e Cross-Border Integration.
In GARAN image URL attribute, enter garan-image-url.
Leave Enable save product list switched on if you want the catalog path. If it is off, only the cart path will carry the value.

Per product

Set the attribute value to the full HTTPS URL of that product’s GARAN PNG. Leave it empty for products with no guarantee.

Product	Attribute value
Alpine Insulated Jacket	`https://cdn.example.com/garan/JKT-4471.png`
Cotton Crew Tee	(empty — no guarantee)

For variable products, see Platform notes — variations do not inherit the parent value by default.

When the value syncs

The catalog path picks the value up when the product is saved or updated, if Enable save product list is on. Saving or updating a variable product also sends its variations. The cart path reads the attribute when the shopper checks out.

Prerequisites

Requirement	Value
Minimum plugin version	Global-e Cross-Border for WooCommerce 1.17.0 or later
Catalog path toggle	Enable save product list must be on to use the Catalog path
Attribute mapping	GARAN image URL attribute must be set to `garan-image-url`
Feature enablement	Confirm with your Customer Success Manager that this feature is enabled for your account

Delivery paths

The value reaches Global-e on two paths: the catalog sync (SaveProductsList) and at checkout (SendCart).

Platform notes

The value must live on a WooCommerce product attribute with slug garan-image-url. A plain custom field or post meta key will not be read.

For variable products, each variation is sent as its own row and reads its own attribute value first. A variation with an empty value falls back to the parent product only when Variation inherit parent attributes is enabled in the Global-e integration settings. That setting is off by default, so unless you turn it on, set the attribute on every variation you want covered.

Payload reference

For technical readers. The field name is GaranImageURL on both the catalog and cart contracts, with no per-path variation. Catalog — POST /Browsing/SaveProductsList

[
  {
    "ProductCode": "JKT-4471-BLK-M",
    "ProductGroupCode": "JKT-4471",
    "Name": "Alpine Insulated Jacket",
    "ImageURL": "https:\/\/cdn.example.com\/products\/jkt-4471-blk.jpg",
    "GaranImageURL": "https:\/\/cdn.example.com\/garan\/JKT-4471.png",
    "OriginCountryCode": "PT",
    "GenericHSCode": "620193"
  },
  {
    "ProductCode": "TEE-1102-WHT-L",
    "Name": "Cotton Crew Tee",
    "ImageURL": "https:\/\/cdn.example.com\/products\/tee-1102-wht.jpg",
    "GaranImageURL": null,
    "OriginCountryCode": "PT",
    "GenericHSCode": "610910"
  }
]

The t-shirt has no guarantee — GaranImageURL is null and no attachment is generated for it. Omitting the property entirely has the same effect as null. Cart — SendCartData.Products[]

{
  "Products": [
    {
      "ProductCode": "JKT-4471-BLK-M",
      "CartItemId": "1057",
      "Name": "Alpine Insulated Jacket",
      "OrderedQuantity": 1,
      "ImageURL": "https:\/\/cdn.example.com\/products\/jkt-4471-blk.jpg",
      "GaranImageURL": "https:\/\/cdn.example.com\/garan\/JKT-4471.png",
      "GenericHSCode": "620193"
    }
  ]
}

Verify

Check	Done
`GaranImageURL` appears in a test catalog payload for a product with a populated attribute	☐
`GaranImageURL` appears in the cart payload for that product at checkout	☐
A product with an empty attribute sends `GaranImageURL` as null or omits it	☐
Each variation of a variable product carries the URL you expect	☐

Activation modes and the general preparation steps — opting in, identifying qualifying products, and creating and hosting the GARAN PNG — are covered on the EU Consumer Guarantee Information (Notice & GARAN) overview page.

FAQ

Do product variants each need their own URL?

By default yes — set the attribute on each variation. If you enable Variation inherit parent attributes, variations with no value of their own will use the parent product’s URL instead.

Can I use a custom field instead of an attribute?

No. The plugin reads the WooCommerce product attribute with slug garan-image-url only.

​One-time setup

​Per product

​When the value syncs

​Prerequisites

​Delivery paths

​Platform notes

​Payload reference

​Verify

​FAQ

One-time setup

Per product

When the value syncs

Prerequisites

Delivery paths

Platform notes

Payload reference

Verify

FAQ