Skip to content
Stone & Water
Doc · 01 Getting started

Get started in 10 minutes

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

1. Check system requirements

  • Shopware: 6.5, 6.6 or 6.7
  • PHP: 8.2 or newer
  • Database: MySQL 8 or MariaDB 10.11
  • PHP memory: at least 256 MB (512 MB recommended for large catalogues)

2. Install plugin

Via Shopware Store

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

Manual via ZIP

  1. Download ZIP from the Shopware Store
  2. Under My extensions → Upload extension
  3. Install and activate
Tip: The plugin triggers the necessary cache refresh automatically — no manual cache clear needed.

3. Grant permissions

Activation registers seven ACL permissions:

  • staw_pim.viewer — view listing
  • staw_pim.editor — inline edit + bulk-edit
  • staw_pim.csv_export / staw_pim.csv_import — CSV
  • staw_pim.variant_generator — variant generator
  • staw_pim.ai_textgen — AI text generation
  • staw_pim.config — edit config matrix

Assign under Settings → System → Users and permissions → Roles.

Important: The CSV import tab is additionally restricted to super admins.

4. Learn the config matrix

Central control under Settings → System → PIM configuration. Seven tabs:

  1. Listing: which columns are shown by default
  2. Bulk-edit: which fields are bulk-editable
  3. Languages: which languages are active
  4. Variants: default SKU and name patterns
  5. Translations & AI: ChatGPT/Claude/DeepL provider config
  6. CSV: export settings, profiles
  7. Quickview: which fields are visible in the Quickview modal

Each tab has a section order via drag-and-drop — the order of sections in the product detail view and in the variant modal can be set freely.

5. Open the first product view

After activation the PIM menu item appears in the admin sidebar. Click it — the listing of all products loads.

Next steps:

  • Create a filter condition (e.g. "Stock < 10")
  • Try inline-edit on a stock value — edit directly in the row
  • Click the Quickview icon to see the compact modal view
  • Make a selection and open Bulk-edit

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.