Skip to content
P2Lab Mirakl

Catalog Export

Before the marketplace can accept any of your products, the operator needs to know how to read them — which CSV column carries the product title, which one is the brand, the EAN, the category and so on. Mirakl does this via a mapping wizard that runs in the operator panel: you upload one sample CSV that represents your catalogue, point and click to map columns to operator attributes, save the result.

This page generates that one-time sample CSV. Once the wizard is set up on the Mirakl side, ongoing product additions go through Catalog and don’t need this page again.

Where to find it

Section titled “Where to find it”

From the Dashboard, open the Quick Start card and click the Catalog Export tile. This opens the Catalog Export page.

What you see

Section titled “What you see”

The grid lists Shopware products eligible for export. Columns:

ColumnMeaning
ProductName (with preview thumbnail when available).
Product NumberThe Shopware product number.
EANEAN / GTIN if set.
ManufacturerManufacturer name.
ActiveWhether the product is active in Shopware.
In StockAvailable stock.
AvailableWhether the product is sellable right now.

The sidebar exposes:

  • Sales Channel — locked to the sales channel tied to the connection (only products visible in that channel can be exported).
  • Active — locked to yes (only active products are sent).
  • Name, Product number, EAN / GTIN — free filters to narrow the list.

The four steps

Section titled “The four steps”

The page shows them inline under the Catalog Mapping info box:

  1. Use the filters to select which products go into the catalogue file.
  2. Click Generate CSV to create the file.
  3. Download the generated CSV file.
  4. Go to your Mirakl panel → Settings → Catalog mapping and run the mapping wizard, uploading the CSV file you just downloaded.

The wizard is a Mirakl-side tool — once you’ve mapped your CSV columns to operator attributes there, the configuration is stored on the operator side and applies to every subsequent product upload.

Background generation

Section titled “Background generation”

CSV generation runs in the background — the plugin queues the export and shows a progress dialog. While generation is running you can:

  • Stay on the page and watch the progress (Stay here).
  • Click Go to Tasks to open the Tasks page where each export job has its own row with a Download action that becomes active once the CSV is ready.

The Tasks button in the toolbar is a shortcut to that page.

Missing fields per row

Section titled “Missing fields per row”

If a product is missing required attributes or required offer fields, the row shows a warning icon. Clicking the icon opens a modal listing exactly which Product attributes and which Offer fields are not filled in. Fix the product in Shopware (or fix the corresponding mapping), then come back and re-generate.

A product missing required fields will not be included in the CSV — it would be rejected by the operator anyway.

Verifying export configuration

Section titled “Verifying export configuration”

Before starting, the plugin runs a Verifying export configuration check that confirms the connection settings and the attribute mappings can produce a usable CSV. If anything’s missing the modal shows the blocker and the export doesn’t start. Fix the cause and try again.

Tips & gotchas

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