Get started in 10 minutes

Install plugin, grant permissions, config matrix basics, open the first product view - step by step.

1. Check system requirements

The PIM runs on any standard Shopware 6 installation, no extra server configuration needed.

• Shopware: 6.6 or 6.7, one package for both lines
• PHP: 8.2 or newer
• Database: MySQL 8 or MariaDB 10.11
• Memory: Shopware's standard recommendation is enough (256 MB and up), 512 MB PHP memory makes sense for large catalogues
• Access: Shopware admin with administrator role for the installation

2. Install plugin

Via Shopware Store

1. In admin, open Extensions → Store
2. Search for "PIM for Shopware" and load it
3. Under Extensions → My extensions click Install
4. Then Activate

Manual via ZIP

1. Download the ZIP file from the Shopware Store
2. Upload it under Extensions → My extensions
3. Install and activate as above

3. What happens on activation

On activation the plugin sets up everything it needs:

• Migrations create the plugin's own tables and its configuration in the database
• The permissions are registered in Shopware's ACL system
• The menu items PIM Dashboard, PIM and PIM Configuration Matrix appear in the Stone & Water menu of the admin
• The config matrix is built with sensible defaults

4. Grant permissions

The plugin brings its own permission group "StawPim (Products)". You find it under Settings → Users & permissions → Roles, choose or create a role, group "Catalogues". There are exactly four roles:

• staw_pim.viewer - View: required for the menu items and all PIM pages.
• staw_pim.editor - Edit: includes the Shopware permission to edit products. The plugin does not check this role separately.
• staw_pim.creator - Create: protects creating new products. Requires view and edit.
• staw_pim.deleter - Delete: includes the Shopware permission to delete products. Requires view.

The Shopware permissions on the respective data apply as well. Without the view permission, dashboard, products and config matrix do not appear in the menu at all. Admin roles see everything as usual.

5. Set up the config matrix

You open the central control via the PIM Configuration Matrix menu item in the Stone & Water menu of the admin. For a start, look at these points:

• General tab: visible columns of the product list, page size and filters
• Products tab: which fields are visible and required in the detail view
• Variants tab: patterns for product number and name, and the quickview fields
• Texts & translations tab: AI providers with API key, model and tone, plus the channel languages for bulk edit and CSV export
• PIM superadmin tab: superadmins and functions for regular users

Ctrl+K searches all settings. All 13 tabs are described in the config matrix documentation.

6. First steps in the PIM

After activation the PIM menu item opens the product list. Then try these four things:

1. Create a filter condition, for example "Stock < 10", and save it as a preset
2. Change a stock value directly in the row
3. Expand the variants of a variant product and click a variant - the quickview window with its master data opens
4. Select a few products and open Bulk edit

7. If something does not work

• Listing does not load: clear the cache, check the browser console and the PHP memory limit (512 MB for large catalogues).
• CSV import aborts: check encoding (UTF-8), delimiter and PHP limits.
• AI generation fails: test the API key under config matrix → Texts & translations → test connection, check the credit balance with Anthropic or the billing status with OpenAI.
• Menu items missing after an update: non-admin users need the permission "StawPim: View" in their role once.

What's next

Read Product listing next to go deeper on filters and columns, or jump straight to Bulk edit, the core of the plugin.

Frequently asked questions