> For the complete documentation index, see [llms.txt](https://docs.momocode.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.momocode.de/en/shopware-6/percentage-based-advanced-pricing/3.-configuration.md).

# 3. Configuration

This plugin has no system-wide settings. The percentage pricing feature is available immediately after installation on the **Advanced prices** tab of every product.

## Defining Percentage-Based Prices

### Step by Step

1. Open a product under **Catalogues → Products**
2. Navigate to the **Advanced prices** tab
3. Click **Add price** or edit an existing price row
4. Enter a value in the **Percentage** column:
   * Negative value → discount (e.g., `-10` for 10% off)
   * Positive value → markup (e.g., `5` for 5% above base price)
5. The absolute price in the **Price** column is calculated automatically
6. Click **Save**

![Price row with percentage value and calculated price](/files/jaMByJrFHR5z5kTuIyAg)

### Input Notes

* Enter plain numbers — no % symbol required
* Positive values increase the price, negative values reduce it
* Existing advanced prices without a percentage value are not affected
* All configured currencies are handled correctly

## Choosing a Calculation Base

For each of the three price types (price, list price, regulation price), you can separately choose whether the percentage is calculated from the product's **sale price** or **purchase price**.

### How the Base Selection Works

Next to each percentage input field, you will see a toggle with two options:

* **Sale price** (default) — calculation uses the product's regular sale price
* **Purchase price** — calculation uses the product's purchase price

![Base toggle next to the percentage field](/files/9zYULmXeeLELbSoLZxhn)

### Example

To define the list price as "purchase price + 20%":

1. Select **Purchase price** as the base for the list price percentage
2. Enter `20` as the percentage value
3. The list price is automatically calculated as purchase price + 20%

### Notes

* The base selection is **always visible**, even before entering a percentage value
* If you select **Purchase price** as the base but no purchase price has ever been set on the product, the calculation is skipped and the existing price remains unchanged. Note: once a purchase price has been entered, clearing the field in the admin sets it to `0` — in that case the calculation runs normally using `0` as the base
* When a product's purchase price changes, all percentage prices using "purchase price" as their base are automatically recalculated

## List Price Field Visibility

When you disable the **Show list prices** toggle in the advanced prices grid, the percentage input fields for list price and regulation price are automatically hidden as well. Only the standard price percentage field is shown.

Re-enabling the toggle restores the fields with their previously entered values — no data is lost.

## Bulk Edit

You can also apply percentage prices to many products at once using Shopware's **bulk edit** feature:

1. Select multiple products under **Catalogues → Products**
2. Click **Bulk edit**
3. Open the **Advanced prices** section
4. Enter the desired percentage values
5. Fill in the absolute price fields with a placeholder value (e.g., `0`)
6. Confirm the bulk edit

The absolute prices are **automatically calculated server-side** for each product individually — based on each product's actual base price. You do not need to open each product separately.

![Bulk edit with percentage values filled in](/files/YkDVQB0Wwdt7ZstCFRu8)

### Bulk Edit Notes

* The instant calculation in the UI is disabled during bulk edit since no single base price is available
* Server-side calculation runs immediately after saving
* You can set both percentage values and calculation base (sale price / purchase price) in bulk edit

## Automatic Recalculation

Absolute prices are automatically recalculated in the following situations:

| Trigger                                     | Effect                                                                 |
| ------------------------------------------- | ---------------------------------------------------------------------- |
| Product's sale price changes                | All percentage prices using "sale price" as base are updated           |
| Product's purchase price changes            | All percentage prices using "purchase price" as base are updated       |
| Percentage value saved via bulk edit or API | Absolute prices are immediately calculated from the current base price |

## Bulk Recalculation (Console Command)

To force a recalculation of all percentage-based prices — for example after a data import or a bulk price update:

```bash
bin/console momo:percentage-prices:recalculate
```

This command recalculates the absolute prices for all percentage-based advanced prices across all products, using the current base prices. The configured calculation base (sale price / purchase price) is respected.

**When is this useful?**

* After a data import that changed base prices
* To verify all prices are up to date
* After migrating from another Shopware version

## How It Interacts with Existing Prices

The plugin extends Shopware's existing pricing — it does not replace it:

* Advanced prices without a percentage value continue to work as before
* Percentage-based and absolute prices can coexist in the same pricing table
* Only rows with a percentage value are automatically recalculated


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.momocode.de/en/shopware-6/percentage-based-advanced-pricing/3.-configuration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.