Skip to content
P2Lab Mirakl

Offer Fields

Mirakl offers carry their own field set — separate from product attributes — covering the seller-specific data attached to each listing (price, lead time, condition, custom operator-specific fields). The plugin pulls this list from the operator and caches it locally so it can be mapped to Shopware fields when offers are synced.

This page is the read-only view of that local cache. You don’t define offer fields here — the operator does — but you can refresh the list and see which fields are linked to which Mirakl connections.

Where to find it

Section titled “Where to find it”

From the Dashboard, open the Quick Start card and click the Offer Fields tile. This opens the Offer Fields page.

What you see

Section titled “What you see”

Columns:

ColumnMeaning
CodeThe operator’s internal code for the field.
LabelHuman-readable name as the operator publishes it.
TypeWhat kind of value the field holds.
RequiredWhether the operator marks this field as required.
SourceStandard (a built-in Mirakl offer field) or Custom (an operator-specific field defined by your marketplace).
ConnectionsWhich Mirakl connections this field is linked to.

The sidebar exposes:

  • Filter by Connection — narrow the list to fields from a specific connection.
  • Filter by Type — filter by data type.
  • Filter by Source — show only Standard or only Custom fields.
  • Filter by Code / Filter by Label — free-text filters.

Refreshing from the operator

Section titled “Refreshing from the operator”

The toolbar has a Refresh Fields action. Clicking it opens a confirmation dialog: “This will fetch operator-specific custom offer fields from Mirakl and link all standard offer fields to the selected connection.”

Confirm and the plugin pulls the operator’s current custom offer fields, plus links every standard offer field to the selected connection. A progress dialog shows Refreshing Offer Fields. When done, a success message reports how many new offer fields were added.

Run this whenever:

  • You connect a new Mirakl operator.
  • The operator adds new custom offer fields.

Standard vs Custom fields

Section titled “Standard vs Custom fields”
  • Standard fields are the same across every Mirakl operator (e.g. price, quantity, state, lead time). They’re seeded automatically when the plugin is installed, and Refresh Fields links them to your connections.
  • Custom fields are operator-specific (e.g. “Gift wrap surcharge” on one marketplace, “B2B tier” on another). Only Refresh Fields can pull them in — they’re operator-specific data.

How offer fields are used elsewhere

Section titled “How offer fields are used elsewhere”

This page is reference data only. The list is consumed by:

  • Mapping → Offer Fields — where you connect each Mirakl offer field to a Shopware product field, custom field or static value.
  • Offer sync — the values sent for each offer come from the mappings of these fields.

Tips & gotchas

Section titled “Tips & gotchas”
Section titled “Related”