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

# EU Deforestation Regulation (EUDR)

Part of [EU Deforestation Regulation (EUDR)](https://docs-pro.global-e.com/eu-deforestation-regulation-eudr.md).

On Magento, the two EUDR values are read from product attributes at checkout and sent to Global-e by the Global-e module. This is a configuration task, not custom code: you create two product attributes, list them in the module settings, and populate the values on your products.

On Magento the attribute codes themselves must be exactly `eudrDdsReference` and `eudrTaricCode`.

## Prerequisites

| Requirement | Value |
| - | - |
| Minimum version | Global-e 2.6.0 |

## What you need to do

1. **Create two product attributes.** Navigate to **Stores**, then **Attributes**, then **Product**.

![Stores menu with Attributes, Product highlighted](https://mintcdn.com/globale-pro/iHTI3ffMIX-a5R-f/images/eu-product-identifiers/magento2-stores-attributes-product.png?fit=max\&auto=format\&n=iHTI3ffMIX-a5R-f\&q=85\&s=d5cac7c7c166b48e36532ab16fe3e84b)

2. Click **Add Attribute** and create two attributes with the codes `eudrDdsReference` and `eudrTaricCode`. Set **Catalog Input Type** to **Text Field** and **Values Required** to **No**.

![New Product Attribute form with the EUDR attribute codes in Default Label](https://mintcdn.com/globale-pro/CMHifVa2VRgciti-/images/eu-deforestation-regulation-setup-magento2-magento2-lite-new-product-attribute-eudr.png?fit=max\&auto=format\&n=CMHifVa2VRgciti-\&q=85\&s=6f4750ef39f7c0087305be03a27a6200)

3. **List them in the Global-e module.** Navigate to **Stores**, then **Configuration**, then **Services**, then **Global-e**, then **Global-E API Settings**, then **Products**. Enter `eudrDdsReference,eudrTaricCode` (comma-separated, no spaces) in both fields: **Extra Product Attributes (Configurable)**, and **Extra Product Attributes (Simple)**. If you already list EU Product Identifiers or US MID attributes, append the EUDR codes to the same list in both fields.

![Extra Product Attributes (Configurable) and (Simple) set to the EUDR attribute codes](https://mintcdn.com/globale-pro/CMHifVa2VRgciti-/images/eu-deforestation-regulation-setup-magento2-magento2-extra-product-attributes-eudr.png?fit=max\&auto=format\&n=CMHifVa2VRgciti-\&q=85\&s=5c8bd10f3753d5a5a77e9dbdf0e5260b)

4. **Save and flush cache.** Click **Save Config**, then flush the Magento cache (**System**, **Cache Management**, **Flush Magento Cache**).

![Flush Magento Cache button in Cache Management](https://mintcdn.com/globale-pro/iHTI3ffMIX-a5R-f/images/eu-product-identifiers/magento2-flush-cache.png?fit=max\&auto=format\&n=iHTI3ffMIX-a5R-f\&q=85\&s=dfc92f51ca106e0c2e6bc286c2f72f20)

5. Populate the values on each variant and/or configurable parent.

| Sent as | What it holds | When to leave it out |
| - | - | - |
| `eudrDdsReference` | The Due Diligence Statement (DDS) reference for that variant | When the item has no DDS reference |
| `eudrTaricCode` | The TARIC document code for that variant | When the item has no TARIC document code |

## Key points

* **One pair of values per cart line.** For simple products, populate that SKU's attributes. For configurable products, set values on the parent, on each child, or both: when a child has no value, the module uses the parent's value.
* **Both settings must match.** List `eudrDdsReference,eudrTaricCode` in both Extra Product Attributes (Configurable) and Extra Product Attributes (Simple).
* **Exact camelCase.** The Magento attribute codes and the keys sent to Global-e are both `eudrDdsReference` and `eudrTaricCode`.
* **Omit, don't fake.** When a variant has no value, leave the key out. Never send an empty string, NA, 0 or -.
* **EU PID keeps working.** `standardcode` and `mididentifier` are sent unchanged alongside the EUDR keys.

## Quick check before go-live

| Check | Done |
| - | - |
| Two attributes created with codes `eudrDdsReference` and `eudrTaricCode`, added to the attribute set | ☐ |
| Both **Extra Product Attributes** settings list `eudrDdsReference,eudrTaricCode` | ☐ |
| Values populated on each variant (or on the configurable parent for inheritance) | ☐ |
| `eudrDdsReference` and `eudrTaricCode` appear when the variant has values | ☐ |
| Keys are omitted (not empty) when a variant has no value | ☐ |
| Configurable child inherits the parent when the child is blank | ☐ |
| Cache flushed after the configuration change | ☐ |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.