> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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.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 plugin version | Global-e plugin 1.14.4 |

You can check your plugin version by looking at: **src/BrowsingLite/etc/module.xml**

## 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-enterprise/TSLEJxyEPjRJOJpp/images/eu-product-identifiers/magento2-lite-stores-attributes-product.png?fit=max\&auto=format\&n=TSLEJxyEPjRJOJpp\&q=85\&s=d11de0c1118ccda1b3c32c4f15340040)

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-enterprise/MMwnCGVEBp9Y6xhy/images/eu-deforestation-regulation-setup-magento2-lite-magento2-lite-new-product-attribute-eudr.png?fit=max\&auto=format\&n=MMwnCGVEBp9Y6xhy\&q=85\&s=055f3ef5001be4b9e4eedb38205c43fc)

3. **List them in the Global-e module.** Navigate to **Stores**, then **Configuration**, then **Services**, then **Global-e Crossborder**, then **Global-E API Settings**, then **Products**. Enter `eudrDdsReference,eudrTaricCode` (comma-separated, no spaces) in both fields: **Extra Product Attributes**, and **Extra Product Attributes From 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 and Extra Product Attributes From Simple set to the EUDR attribute codes](https://mintcdn.com/globale-enterprise/MMwnCGVEBp9Y6xhy/images/eu-deforestation-regulation-setup-magento2-lite-magento2-lite-extra-product-attributes-eudr.png?fit=max\&auto=format\&n=MMwnCGVEBp9Y6xhy\&q=85\&s=ecf5c4f0e6ef670f14477f4b3bdd6b81)

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-enterprise/TSLEJxyEPjRJOJpp/images/eu-product-identifiers/magento2-lite-flush-cache.png?fit=max\&auto=format\&n=TSLEJxyEPjRJOJpp\&q=85\&s=412f2d136c36382099fd2e95a71da070)

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 and Extra Product Attributes From 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.