Installation

For merchants

Requirements

• Shopware 6.6 or 6.7 — ideally a fresh installation; never a live shop.
• PHP 8.2+.
• Outbound internet on the first run to download product photos (without it, bundled fallback images are used).
• For runs started from the Administration: a message-queue worker, or an Administration tab left open.

1. Install the plugin

Option A — Composer from the repository (recommended)

Do not require it by name alone

kommandhub/demo-data-sw on Packagist is an older, different package (1.0.0-alpha). Add this plugin's repository first.

// composer.json (project root)
"repositories": [
  { "type": "vcs", "url": "https://github.com/KommandHub/KmhDemoDataSW.git" }
]

composer require "kommandhub/demo-data-sw:^0.9@beta"

Background: Shopware: extension management.

Option B — ZIP upload

Extensions → My extensions → Upload extension (Shopware: My extensions), select the 0.9.0-beta.2 ZIP.

2. Activate

bin/console plugin:refresh
bin/console plugin:install --activate KmhDemoDataSW
bin/console cache:clear

Activation only adds the kmh_demo_data custom-field set on products and categories, the Settings → Extensions → Demo data screen and the kmh:demo-data:* commands. No demo data is created until you run the generator.

3. Settings

The plugin needs no configuration. Its settings (Extensions → My extensions → Demo Data → ⋯ → Configure) only control logging:

Setting	Key	Default	Description
Enable debug logging	KmhDemoDataSW.config.enableDebugging	Off	Also write debug/info entries to var/log/kommandhub_demodata_<env>.log. Errors are always logged.
Log levels	KmhDemoDataSW.config.logLevels	all	Restrict debug logging to these levels.

4. Permissions

For non-administrators, grant in Settings → Users & permissions → Roles → Settings (Shopware: Users & permissions):

Permission	Allows
Demo data → Generate (kmh_demo_data.generate)	Open Settings → Extensions → Demo data and start a run
Demo data → Manage user (kmh_demo_data.manage_user)	Create the read-only demo login (requires Generate)

5. Generate and verify

bin/console kmh:demo-data:seed
bin/console theme:change --all --sync Storefront
bin/console dal:refresh:index

Verify:

1. The command ends with a tally — on a fresh shop, mostly created.
2. Sales Channels lists the five Kommandhub … storefronts (the flagship one adopts your existing Storefront).
3. Open a storefront: categories, products with photos, reviews and a landing page.
4. bin/console kmh:demo-data:seed again reports 0 created, 0 enriched.

Details and options: Generating demo data.

Updating

composer update kommandhub/demo-data-sw     # or upload the new ZIP
bin/console plugin:refresh
bin/console plugin:update KmhDemoDataSW
bin/console cache:clear

Run the seeder again afterwards to top up anything a new version adds.

Uninstalling

Extensions → My extensions → ⋯ → Uninstall, or bin/console plugin:uninstall KmhDemoDataSW.

Generated data is never deleted — sales channels, products, customers and orders stay, because other data may reference them by then. Without keep plugin data, only the kmh_demo_data custom-field set is removed. To get rid of demo data, start from a fresh database.