2. Installation

Installing the plugin

Via the Shopware Store (recommended)

1. Open Extensions → Store in the Shopware administration.

2. Search for "Margins & Purchase Prices in Product Listing".

3. Click Buy or Install.

4. The plugin is downloaded and installed automatically.

Manual installation via ZIP

1. Download the plugin ZIP file from your Shopware account.

2. Open Extensions → My Extensions in the administration.

3. Click Upload plugin and select the ZIP file.

4. The plugin will appear in the plugin list.

Activating the plugin

1. Open Extensions → My Extensions.

2. Find Margins & Purchase Prices in Product Listing in the list.

3. Toggle the switch to activate the plugin.

4. Confirm the cache clear if prompted.

First steps after installation

Once activated, the plugin automatically starts a background indexing run to calculate margin data for all existing products. The new columns are immediately visible:

1. Open Catalogues → Products.

2. Scroll right in the table — you will see four new columns: Purchase Price, Net Price, Margin, and Margin %.

3. While the background indexing is in progress, the margin columns may still show a dash (–). This is normal — values fill in as the indexing completes.

4. Products without a stored purchase price will always show a dash (–) in the margin columns. Add purchase prices directly on the product page under the List price → Purchase price field.

Using the purchase price filter

To quickly find all products without a purchase price:

1. Open Catalogues → Products.

2. Click the Filter icon (funnel) in the upper right corner.

3. Scroll down in the filter panel to the Purchase Price section.

4. Select Without purchase price.

5. The product list will show only products without a stored purchase price.

Filter panel with active purchase price filter

Notes

• The Margin and Margin % columns are calculated based on the net price in the default currency and the stored purchase price.

• For products with variants, each variant must have its purchase price set individually.

• Sorting by margin and margin % is server-side and uses a precomputed database table. The plugin stores both calculation methods (Gross Margin and Markup) simultaneously, so switching the method in the configuration takes effect immediately without a re-index. The table is updated automatically whenever prices change.