EU Consumer Guarantee - Global-e Docs

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

One-time setup

In Centra, go to System → Configuration and create a custom product attribute group named ge_product_data. If that group already exists for other Global-e product fields, add the element in step 2 to it — Centra does not allow two attribute groups with the same name, so you cannot create a second group.
Add an element with key garan_image_url, type input, description Global-E GARAN Label Image URL.
The Global-e adapter reads these names as-is. There is no mapping dropdown in the adapter.

Attribute definition:

{
  "desc": "Global-E Product Information",
  "readonly": false,
  "group": "product",
  "elements": {
    "garan_image_url": {
      "type": "input",
      "desc": "Global-E GARAN Label Image URL"
    }
  }
}

Per product

On each qualifying product, set Global-E GARAN Label Image URL 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)

Set this at product level. All size and colour variants of the same product carry the same URL.

When the value syncs

The value is read when the shopper checks out, on both Centra’s DTC API and the Checkout API. Updating the product attribute alone does not send the label — a checkout must run.

Prerequisites

Requirement	Value
Minimum adapter version	Global-e Centra adapter 1.5.0 or later
Attribute	Group `ge_product_data`, element `garan_image_url`
Catalog path	Not supported in the current release
Feature enablement	Confirm with your Customer Success Manager that this feature is enabled for your account

Delivery paths

SendCart only: SendCartData.Products[].GaranImageURL. The adapter reads the same attribute on both Centra’s DTC API and Checkout API at checkout — you do not set a second field.

Platform notes

The group name and element key are fixed. A differently named attribute will not be read; the adapter will send GaranImageURL as null and will not error.

The attribute is product-level (group: product). All size and colour variants of the same product carry the same URL. Per-SKU or per-variant values are not supported in the current implementation.

Payload reference

For technical readers. The field name is GaranImageURL on SendCart (SendCartData.Products[]). 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 the SendCart payload for that product at checkout (DTC and/or Checkout API, whichever you use)	☐
A product with an empty attribute sends `GaranImageURL` as null or omits it	☐
Size and colour SKUs of the same product carry 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 I need a different field for DTC vs Checkout API?

No. The same ge_product_data / garan_image_url attribute is read on both checkout paths.

Do product variants each need their own URL?

No. Set the value on the product — all size and colour variants inherit the same URL. Per-variant values are not supported in the current implementation.

Can I name the attribute something else?

No. The adapter looks up this group and element by those exact keys. A different name is treated as missing and sent as null.

​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