Product Attribute Mapping¶
Etsy calls product details such as Color, Size, or Material attributes (item specifics). Odoo has its own product attributes. To make sure the right information is sent to Etsy, the two must be linked. This linking is done with Product Attribute Mapping (attribute-to-attribute) and Product Attribute Value Mapping (value-to-value).
The connector supports mapping at two levels:
Global level — applies across all Etsy categories on the instance.
Category-specific level — applies only to listings in a particular Etsy category.
When a listing is imported or exported, the connector first looks for a category-specific mapping for that listing’s Etsy category. If none is found, it falls back to the global mapping. If neither is found, the attribute is skipped (no error is raised).
Global Level Mapping¶
Use the global level when an Odoo attribute should map to the same Etsy attribute everywhere — for example, your Odoo Colour attribute always maps to the Etsy Primary color property regardless of the listing category.
Product Attribute Mapping (Odoo attribute ↔ Etsy attribute)
Go to .
For each line, pick the Odoo Attribute and the matching Etsy Attribute (taxonomy property).
Product Attribute Value Mapping (Odoo value ↔ Etsy value)
Go to .
Pick the Etsy Attribute, the Etsy Value, and the matching Odoo Attribute Value. Allowed Odoo values are limited to the values of the Odoo attribute linked through the Attribute Mapping above.
Category-Specific Level Mapping¶
Use the category-specific level when an Odoo attribute should map differently depending on the listing’s Etsy category — for example, your Odoo Size attribute may need to use Ring Size for jewelry categories and Shoe Size for shoe categories.
Go to and open the category you want to configure.
On the category form, add lines for the Etsy Attribute and the matching Odoo Attribute. These mappings apply only to listings in this category.
For each attribute line, add the corresponding Value Mappings (Etsy value ↔ Odoo value) so per-category values are sent correctly.
Tip
When you fetch a category’s properties (see Product Categories), Odoo auto-maps an Etsy value to an Odoo value if both have the same name. Unmatched entries are created so you can map them manually.
How values are auto-mapped¶
During the property fetch, Odoo creates an Etsy value record for every allowed Etsy value.
If an Odoo value with the same name already exists for the linked Odoo attribute, the value mapping is filled in automatically.
If not, the value mapping line is created empty so you can map it manually later.
Why it matters¶
Etsy only accepts attribute values from its own list. Mapping prevents export errors caused by unknown values.
Correct attributes help buyers filter and find your listing on Etsy.
Note
If an export fails because of an attribute value, check that the Odoo value has a matching Etsy value in the corresponding Value Mapping (category-specific first, then global).
See also