Product Attributes
Mirakl operators publish their product attributes — the fields they expect every product to carry (name, brand, EAN, category-specific specs, etc.). The plugin pulls that list from the operator and stores it locally so it can be referenced anywhere a Shopware-to-Mirakl mapping is needed.
This page is the read-only view of that local cache. You don’t define attributes here — the operator does — but you can refresh the list whenever the operator updates their catalogue model.
Where to find it
Section titled “Where to find it”From the Dashboard, open the Quick Start card and click the Product Attributes tile. This opens the Product Attributes page.
What you see
Section titled “What you see”Columns:
| Column | Meaning |
|---|---|
| Code | The operator’s internal code for the attribute. |
| Label | Human-readable name as the operator publishes it. |
| Type | What kind of value the attribute holds (text, list, number, etc.). |
| Required | Whether the operator marks this attribute as required. |
| Connections | Which Mirakl connections this attribute is linked to. |
The sidebar exposes:
- Filter by Connection — narrow the list to attributes from a specific connection.
- Filter by Type — show only attributes of a certain type.
- Filter by Code / Filter by Label — free-text filters.
Refreshing from the operator
Section titled “Refreshing from the operator”The toolbar has a Refresh Attributes action. Clicking it opens a confirmation dialog: “This will fetch the latest product attributes from Mirakl. Existing attributes will be updated.”
Confirm and the plugin pulls the operator’s current attribute list. A progress dialog shows Refreshing Product Attributes. When done, a success message reports how many new attributes were added.
You should run this whenever:
- You connect a new Mirakl operator for the first time.
- The operator announces a catalogue model update.
- The list looks out of date compared to the operator’s panel.
How attributes are used elsewhere
Section titled “How attributes are used elsewhere”This page is reference data only — you don’t act on it directly. The list is consumed by:
- Mapping → Attributes — where you connect each Mirakl attribute to a Shopware field, custom field or property group.
- Catalog Export — the CSV’s columns come from the attributes you’ve mapped.
- The validation that prevents products with missing required attributes from being added to the catalogue.
Tips & gotchas
Section titled “Tips & gotchas”Related
Section titled “Related”- Mapping → Attributes — map these to Shopware fields
- Offer Fields — the offer-side reference list (different concept)
- Catalog Export — uses the mapped attributes when building the catalogue CSV