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

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-magento2-lite-new-product-attribute-eudr.png?fit=max\&auto=format\&n=MMwnCGVEBp9Y6xhy\&q=85\&s=bc9685560e3bddfe77c9f8797a8084c9)

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

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-flush-cache.png?fit=max\&auto=format\&n=TSLEJxyEPjRJOJpp\&q=85\&s=b2767d0a81950ca02db9235c0fa08afd)

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.