Doc · 09 Config matrix

Config matrix · adapt the PIM to your workflow

The config matrix is the central control of the plugin. In 13 tabs it defines which fields are visible and required, how variants, SEO URLs, AI, import and bulk edit work and which functions regular users see.

Where to find it

You open the config matrix via the PIM Configuration Matrix menu item in the Stone & Water menu of the Shopware admin. Whether regular users see it is controlled by the superadmin switch "PIM configuration". A quick search with Ctrl+K (Mac: ⌘+K) searches all tabs, shows the number of hits per tab and jumps from hit to hit with next/previous buttons. Changes are applied with "Save".

The 13 tabs and their key settings

1. General

• Redirect the standard product list to PIM (Catalogues → Products opens the PIM list)
• Keep filters persistent, optionally including the search term
• Default page size: 10, 25, 50 or 100 entries
• Compact variant view
• Visible columns of the product list, order and custom columns
• Sticky channel & language bar, scroll-to-top button, cover image always first
• Visible filters and quick filters

2. Dashboard

• Include variants
• Thresholds: critical stock from (default 5), short description below (default 50 characters)
• KPI cards, data quality checks and completeness weighting (ignore, 1×, 2×, 3×) - more on the Dashboard page

3. Products

• Tab visibility of the detail page ("Master data" is always visible)
• Visible sales channels
• Group custom fields by set
• Rounding of linked tier prices and "Update tier prices automatically"
• Preview for inactive products with the duration of the temporary activation (15 to 120 seconds)
• Per field: visible in the detail view and marked as required; order of the sections

4. Variants

• Product number pattern (default {parentNumber}-{options}), separator, option name format, max. product number length
• Variant name pattern (default {parentName} {options})
• Set main variant automatically with strategy (first generated variant or lowest product number), hide main product in listing
• Automated property assignment, always write variant properties to the main product too
• Matrix view: default view, default value (price, stock, active), max. variants (default 500)
• Fields, required fields and sections of the variant view, custom fields by set
• Quickview fields (variant editing in the listing)

5. SEO URLs

• Shopware standard SEO URL or the two-generator system, each with display in the variant modal and the quickview
• Field pattern and URL pattern (Twig), own patterns per sales channel, category path source, separator, lower case, umlaut conversion

6. Texts & translations

• Show main language as placeholder
• Visible channel languages for bulk edit and CSV export
• Master prompt and length targets for AI texts
• DeepL, ChatGPT, Claude, Mistral and Gemini: enable, API key, model, test connection, default tone; for DeepL, ChatGPT and Claude also the switch for bulk edit, for ChatGPT and Claude the number of parallel requests

7. Import / export

• Performance: products per sync batch, parallel image uploads per product, concurrent products during image import, translations per sync batch, API rate limit
• Disable indexing during import, re-index automatically after import, abort import at an error count
• Export: default export profile, separator, max. products (default 5,000), export variants by default, default file format, decimal separator

8. Bulk edit

• Show missing translations in bulk edit
• Batch size, max. products via preset filter (default 500), write size per API request
• Create snapshot before changes, confirmation before applying, revert automatically on cancel
• Include variants by default

9. Approval

• Enable approval workflow, approvers (user names)
• Approval logging, retention with automatic clean-up, statistics, clean up data - more under Approval workflow

10. Change history

• Automatic clean-up, retention period (7 days to 1 year, default 90 days), maximum entries per product (default 100)
• Change history enabled, delete the entire change history

11. Snapshots

• Automatic clean-up, retention period (default 90 days), maximum number (default 50)
• Create snapshots for bulk edits and for CSV imports, diff view for both
• Snapshot lists with show diff, restore and delete

12. External systems

• Protection against external systems: protected languages, fields and integrations, trigger, waiting time, reference state and log - more under External system guard

13. PIM superadmin

• Superadmin users, visibility and functions for regular users, edit lock, reset PIM to defaults - visible to superadmins only, more under Permissions & superadmin

Fields and sections

In the Products and Variants tabs you make each field visible or invisible in the detail view or the variant view and mark it as required if needed ("Required (manual)"). Fields that Shopware requires anyway are labelled "Required" and cannot be deactivated. Which fields appear in the quickview of the product list is set in the Variants tab. There is no separate "Quickview" tab.

Order via arrow buttons

You set the order of the sections in the product detail view, such as master data, prices, media, SEO, properties and cross-selling, in the Products tab, and the order in the variant view in the Variants tab - each with "Move up" and "Move down".

Custom columns

In the General tab you add your own columns next to the standard ones. The source is a master data field or any custom field, optionally sortable. Date and yes/no values are formatted automatically.

Gross and net prices

All four price types can be shown or hidden independently for gross and net, separately for main products and variants:

• Selling price
• Purchase price
• List price / RRP
• Lowest price of the last 30 days (Omnibus)

This allows pure gross maintenance, pure net maintenance or a mixed view. Existing settings remain valid, no migration needed.

SEO URLs: two ways

In the SEO URLs tab you choose between the Shopware standard (edit the native SEO URL directly in PIM) and the two-generator system (token pattern into a custom field, Twig template for Shopware's SEO URLs with 301 redirects). Both ways, the variables and the console command are described on the SEO URLs page.

Functions for regular users

In the PIM superadmin tab you define the superadmins and switch individual functions on or off for all other users, including create and duplicate products, bulk edits, generate variants, delete, CSV import and export, feed generator and manage categories. In addition there are visibility switches for the config matrix and the dashboard, and the edit lock. Details on the Permissions & superadmin page.

Settings apply to all users

Column selection, page size, tone and all other settings of the config matrix apply shop-wide to all users. Filter presets are also stored in the database and available to everyone. There is no separation per user - you control different permissions with the superadmin list and the function switches.

Required fields with jump to the spot

If a required field is missing when saving in the detail view, a window with all errors opens. A click jumps to the affected section, expands it and briefly highlights the field.

What's next

The fields you enable here are used mainly in bulk edit and the product listing. Setting up AI providers is covered in AI text generation.

Frequently asked questions