PrestaShop - Global-e Docs

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

One-time setup

In Catalog → Attributes & Features, create a feature named, for example, Global-e GARAN Image URL.
In Global-e plugin settings, find the GARAN Image URL dropdown and select that feature.
If using the Catalog path, confirm Enable save product list is switched on. If it is off, only the cart path will carry the value.

Per product

Populate the mapped feature once on each eligible parent product. Leave it empty for products with no guarantee. Features cannot differ by combination — see Platform notes.

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

The plugin then emits GaranImageURL automatically on both the catalog sync and at checkout.

When the value syncs

The value is picked up on product save.

Prerequisites

Requirement	Value
Minimum plugin version	Global-e PrestaShop plugin 1.11.0 or later
Catalog path toggle	Enable save product list must be on to use the Catalog path
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 and at checkout. Where both supply a value for the same product, the Catalog value wins.

Platform notes

PrestaShop Features cannot differ by combination. Size and colour variants of the same parent product inherit the same URL, and you cannot assign a different GARAN URL per combination. The plugin still sends one catalog and cart row per combination SKU; each row carries a copy of the parent value.

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",
    "Weight": "1200",
    "OriginCountryCode": "PT",
    "GenericHSCode": "620193"
  },
  {
    "ProductCode": "JKT-4471-BLK-L",
    "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",
    "Weight": "1250",
    "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,
    "Weight": "180",
    "OriginCountryCode": "PT",
    "GenericHSCode": "610910"
  }
]

The two jacket combination SKUs (M and L) share the same GaranImageURL because the Feature was set once on the parent product. 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 Feature	☐
`GaranImageURL` appears in the cart payload for that product at checkout	☐
A product with an empty Feature sends `GaranImageURL` as `null` or omits it	☐
Combination SKUs of the same parent all carry the same URL	☐

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?

No. Set the Feature once on the parent product. Each combination SKU (size, colour) carries a copy of that same URL to Global-e. You cannot assign a different GARAN URL per combination on PrestaShop.

​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