> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/milestone-recommendations.md).

# Milestone recommendations

Milestone recommendations show products in the cart whose price closes the gap to the next goal of the progress bar, for example free shipping.

{% hint style="info" %}
Available from plan Starter. The mode "Matching products only" and the price weighting are available from plan Expert.
{% endhint %}

If your shop uses the "Progress bar" plugin to show, for example, "20 € left until free shipping", Cross Selling Pro can suggest products that fit exactly. In the offcanvas cart and on the cart page, products whose price closes the gap to the next milestone then move to the front. The customer reaches the goal with one click, and your cart value goes up.

## Requirements

* The **"Progress bar"** plugin by codegiganten is installed, active and switched on in its own settings. You need at least version 2.5.0 for Shopware 6.7 or 1.4.0 for Shopware 6.6.
* An **active recommendation template** is set up at the respective placement (offcanvas cart or cart page). The milestone products are mixed into its list. Without an active template the feature has no effect.
* Your plan is at least **Starter**.

If the progress bar is missing or not ready, the section is greyed out in the Administration. A notice tells you what to do, for example "Install the progress bar to use this feature." or "Enable the progress bar in its settings to use this feature.". The link "Progress bar in the Shopware Store" leads to the plugin.

## Setting it up

{% stepper %}
{% step %}

### Enable cart recommendations

Set up a recommendation template at the placement offcanvas cart and/or cart page and enable the recommendations there. How to do this is described on the page [Cart and offcanvas cart](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/cart-and-offcanvas-cart.md).
{% endstep %}

{% step %}

### Open the milestone section

Open **Content → InsightSearch**. In the sidebar, choose **Delivery → Placements** and there **Milestones**. In the plugin configuration you also find the card "Milestone recommendations" with a link to this page.
{% endstep %}

{% step %}

### Switch the feature on

Switch on "Consider products up to the next milestone" and check whether "Use in cart offcanvas" and "Use on cart page" are set the way you want.
{% endstep %}

{% step %}

### Adjust values and save

If needed, adjust the tolerance, the number of milestones and the positions at the front. Then save.
{% endstep %}
{% endstepper %}

<figure><img src="https://923488348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FebcjSiStaIxyVJ83vjsL%2Fuploads%2Fgit-blob-15d0be0d5121f9ec9af493f269992083db62da58%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-ausspielorte-meilenstein.png?alt=media" alt="Placements page, Milestone section"><figcaption></figcaption></figure>

## Settings

| Setting                                      | Effect                                                                                                                                                        | Default |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| "Consider products up to the next milestone" | switches milestone recommendations on                                                                                                                         | off     |
| "Use in cart offcanvas"                      | applies in the offcanvas cart. Requires an active recommendation template for the cart offcanvas.                                                             | on      |
| "Use on cart page"                           | applies on the cart page. Requires the cart recommendations to be enabled.                                                                                    | on      |
| "Number of milestones"                       | how many open milestones are considered, starting with the next one (1 to 3)                                                                                  | 1       |
| "Tolerance above the remaining amount (%)"   | how much more expensive than the missing amount a product may be (0 to 100)                                                                                   | 30      |
| "Positions at the front"                     | maximum number of milestone products placed at the front (1 to 6). The remaining positions keep the regular recommendations; the total number stays the same. | 3       |
| "Mode" (from Expert)                         | "Weight (similar products stay, matching price moves up)" or "Matching products only"                                                                         | Weight  |
| "Price weighting (%)" (from Expert)          | 0 % = similarity only, 100 % = price fit only (0 to 100)                                                                                                      | 50      |

Without the Expert plan, "Mode" and "Price weighting (%)" are hidden. A plan notice is shown in their place.

{% hint style="info" %}
The colours of the bar are set in the "Progress bar" plugin. Cross Selling Pro does not change them. The link "Open progress bar settings" takes you straight there.
{% endhint %}

## How it is calculated

### The price range

Cross Selling Pro looks for products whose price lies between the missing amount and the missing amount plus the tolerance.

**Example:** 20 € are missing until free shipping, the tolerance is set to 30 %. Then products from 20 € to 26 € fit. Cheaper products do not count, because they do not reach the goal.

With "Number of milestones" set to 2 or 3, each open milestone gets its own price range.

### Which products qualify

* Only products that **count towards the milestone** according to the progress bar.
* The check uses the **customer's real price** (including customer group, price tiers and minimum purchase), not a list price.
* Products with variants that only have a "from" price are left out, because their final price is only known after the variant is chosen.
* Products that are already in the cart are not suggested.
* If the cart is empty, there are no milestone products.

### Which products are selected

| Plan        | Selection within the price range                                                                                                                                                                                                                                                                  |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Starter     | a random selection of matching products. Within one visit the order stays the same on the same day. Stock and the rules of the template apply.                                                                                                                                                    |
| from Expert | products similar to the reference product of the template, mixed with the price fit. A product exactly at the missing amount fits best. How much the price counts is controlled by "Price weighting (%)". If there are too few similar matches, the list is filled up with the Starter selection. |

### What the list looks like

* **"Weight":** up to "Positions at the front" milestone products are at the front, followed by the regular recommendation list. The total number of cards does not change.
* **"Matching products only":** only milestone products appear. If none match, the block shows the regular recommendations.

If the request does not answer within 1.5 seconds or an error occurs, the regular list simply appears. The cart never waits long.

## Where milestone recommendations appear

Only in the **offcanvas cart** and on the **cart page**. In the customer account, on the [checkout interstitial page](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/checkout-interstitial-page.md) and in Shopping Experience elements there are no milestone products.

## Quota and statistics

* Each time milestone recommendations are loaded, this is a separate request and counts towards your monthly quota in addition to the regular recommendation. More on the page [Requirements and plans](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/requirements-and-plans.md).
* In the statistics, the products stay assigned to their area (offcanvas or cart) and are additionally marked as milestone products.

## If no milestone products appear

Go through these points in order:

1. Is the progress bar installed in the required version, active and switched on in its settings?
2. Is "Consider products up to the next milestone" switched on, and does it apply to the placement you are checking?
3. Does the placement have an active recommendation template?
4. Is your plan at least Starter?
5. Is there something in the cart, and has the milestone not been reached yet?
6. Are there products in the price range that count towards the milestone? Increase the tolerance as a test.
7. Are the matching products perhaps only variant products with a "from" price?

<details>

<summary>Example for a shop with free shipping from 50 €</summary>

A customer has goods worth 38 € in the cart. The progress bar shows "12 € left until free shipping". With 30 % tolerance, Cross Selling Pro looks for products between 12 € and 15.60 €. With "Positions at the front" set to 3 and a block with 6 cards, up to three such products are at the front, followed by three regular recommendations.

</details>

## Read more

{% content-ref url="/pages/pxHB3cEfqEF3UVF3LQ5h" %}
[Cart and offcanvas cart](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/cart-and-offcanvas-cart.md)
{% endcontent-ref %}

{% content-ref url="/pages/T18Rtfo4NyPNuI34n60w" %}
[Placements](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/placements.md)
{% endcontent-ref %}

{% content-ref url="/pages/EcsOGIKxOKzqWlk6mPRy" %}
[Working with other plugins](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/working-with-other-plugins.md)
{% endcontent-ref %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/milestone-recommendations.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
