> ## Documentation Index
> Fetch the complete documentation index at: https://docs-nce.global-e.com/llms.txt
> Use this file to discover all available pages before exploring further.

# EU Consumer Guarantee

Part of the [EU Consumer Guarantee (Notice & GARAN) - Platform Setup Guides](/eu-consumer-guarantee-platform-setup-guides).

## One-time setup

There is no plugin mapping screen for this field. After you install a Global-e Hybris addon that includes GARAN support, each product shows **GARAN Image URL** in Backoffice.

## Per product

1. In Backoffice, go to **Catalog → Products** and open the product.
2. Open the **Administration** tab.
3. In **GARAN Image URL**, enter the full HTTPS URL of that product's GARAN PNG. Leave it empty for products with no guarantee.
4. Save the product.

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

This is not the product photo. Multimedia / `ImageURL` stays the storefront image.

For variants, see [Platform notes](/eu-consumer-guarantee-setup-hybris#platform-notes) — an empty variant field can inherit the parent URL.

## When the value syncs

The value is sent on checkout, on the SendCart payload for that cart line.

## Prerequisites

| Requirement | Value |
| - | - |
| Minimum addon version | Global-e Hybris addon 2211.11.2 or later |
| Merchant field | **GARAN Image URL** on the product in Backoffice |
| Catalog path | Not available on this platform |
| Feature enablement | Confirm with your Customer Success Manager that this feature is enabled for your account |

## Delivery paths

SendCart only: `SendCartData.Products[].GaranImageURL`.

## Platform notes

<Warning>
  Do not put the GARAN PNG in the product image / multimedia slot. The addon keeps `ImageURL` (storefront photo) and `GaranImageURL` (guarantee label) as separate fields.
</Warning>

If a variant's **GARAN Image URL** is empty and the parent product has a value, the cart line uses the parent URL. Set the field on the parent if every variant shares one label; set it on the variant when a size or colour needs a different file. Same behaviour as Shopware 6.

## Payload reference

For technical readers. The field name is `GaranImageURL` on SendCart (`POST /Checkout/SendCartV2`).

**Cart — SendCartData.Products\[]**

```json theme={null}
{
  "Products": [
    {
      "ProductCode": "29533",
      "CartItemId": "0",
      "Name": "Snowboard Ski Tool Toko Ergo Multi Guide yellow",
      "NameEnglish": "Snowboard Ski Tool Toko Ergo Multi Guide yellow",
      "ImageURL": "https:\/\/cdn.example.com\/products\/jkt-4471-blk.jpg",
      "ImageHeight": 0,
      "ImageWidth": 0,
      "GaranImageURL": "https:\/\/cdn.example.com\/garan\/JKT-4471.png",
      "ListPrice": 65.00,
      "OrderedQuantity": 1
    },
    {
      "ProductCode": "45572",
      "CartItemId": "1",
      "Name": "Snowboard Ski Tool Toko Waxremover HC3 500ml",
      "NameEnglish": "Snowboard Ski Tool Toko Waxremover HC3 500ml",
      "ImageURL": "https:\/\/cdn.example.com\/products\/tee-1102-wht.jpg",
      "ImageHeight": 0,
      "ImageWidth": 0,
      "GaranImageURL": null,
      "ListPrice": 0.00,
      "OrderedQuantity": 1
    }
  ]
}
```

SKU 29533 has a GARAN URL. SKU 45572 has none — `GaranImageURL` is `null` and no attachment is generated for that line. The storefront photo remains on `ImageURL`.

## Verify

| Check | Done |
| - | - |
| Product in Backoffice **Administration** has **GARAN Image URL** set to an HTTPS PNG | ☐ |
| A test checkout SendCart payload includes `GaranImageURL` for that SKU | ☐ |
| A product with an empty field sends `GaranImageURL` as null | ☐ |
| A variant with an empty field inherits the parent URL when the parent is set | ☐ |
| `ImageURL` is still the storefront photo, not the GARAN file | ☐ |

<Note>
  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)](/eu-consumer-guarantee-notice-and-garan) overview page.
</Note>

## FAQ

<AccordionGroup>
  <Accordion title="Do variants each need their own URL?">
    Only if they differ. An empty variant field uses the parent product's value.
  </Accordion>

  <Accordion title="Can I reuse the product image?">
    No. Use **GARAN Image URL** for the official label PNG.
  </Accordion>
</AccordionGroup>