> 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/images-prices-and-fallbacks.md).

# Images, prices and fallbacks

Fallbacks for too few recommendations, a replacement image, live prices, the visibility check and how Cross Selling Pro handles out-of-stock products.

This page brings together the settings that apply to all recommendations: What happens when a template finds too few products? Which image appears for products without an image? Which price is shown on the card? And how do you prevent customers from seeing products they are not allowed to buy or cannot buy?

You set the fallback per template. Replacement image, live prices and visibility are in the plugin configuration.

## Where to find the settings

* **Fallback:** in the [recommendation template](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/recommendation-templates.md), section "5. Display".
* **Replacement image, live prices, visibility:** in the plugin configuration. Open it via **Extensions → My extensions** with "Configure" on the plugin, or in the plugin dashboard via the sidebar **System → Plugin configuration**. As everywhere in Shopware, you can set the values for all sales channels or for a single sales channel. A value in the sales channel takes priority.

## Fallback when too few recommendations come back

Without a fallback, a block disappears completely when the template delivers nothing. With a fallback you show other products in this case.

| Setting                   | Effect                                                                                                               | Default       |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------- | ------------- |
| "Fallback threshold (≤)"  | The fallback is used when the number of loaded products is less than or equal to this value (0 to 50).               | 0             |
| "Fallback type"           | where the fallback products come from: "No fallback", "Other template", "Fixed products" or "Dynamic product stream" | "No fallback" |
| "Fallback template"       | the second template that fills in (with "Other template")                                                            |               |
| "Fallback products"       | products you select yourself (with "Fixed products")                                                                 |               |
| "Fallback product stream" | the dynamic product stream (with "Dynamic product stream")                                                           |               |

This is how the fallback behaves in the shop:

* If **no** products came back, the block shows only the fallback products.
* If **some** products came back, but no more than the threshold, the fallback fills up to the limit of the template.
* Fallback products are marked as fallback in the statistics and still count towards the place where they appeared.

**Example:** limit 6, threshold 3, type "Other template" with a bestseller template. If the template finds only 2 products, the block adds 4 bestsellers.

{% hint style="warning" %}
The fallback "Other template" only works in **Shopping Experience elements** and in the **Conversion Booster**. In the offcanvas cart, on the cart page and in the customer account this fallback does not exist. Use "Fixed products" or "Dynamic product stream" there.
{% endhint %}

Good to know:

* The recommendation type of the fallback template must be included in your plan. Otherwise the fallback is skipped.
* With "Dynamic product stream", Cross Selling Pro takes at most 50 products of the stream, sorted by stock (highest first) and then by sales.
* The default values "0" and "No fallback" mean: if the template delivers nothing, the block disappears.

## Replacement image for products without an image

In the plugin configuration, card "Product images", choose an image from the media under **"Image for products without an image"**.

The image appears in all recommendations when a product has no image or its image cannot be loaded: in Shopping Experience elements, in the offcanvas cart and on the cart page, for milestone products, in the bundle/set configurator, in the preview window and in the Conversion Booster.

If you do not select an image, Cross Selling Pro uses the replacement image from the InsightSearch search plugin, if one is set there. Otherwise a grey placeholder appears.

{% hint style="info" %}
Your own replacement image with your logo or in your shop colours usually looks calmer than the grey placeholder.
{% endhint %}

## Live prices

In the plugin configuration, card "Live prices", you find the switch **"Show live prices from Shopware"**. It is **off** by default.

| State         | Which price is shown on the card                                                                                                                                              |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| off (default) | the price InsightSearch knows from your product feed or from the data transfer. It can differ from a customer's price, for example with customer group prices or net display. |
| on            | the real, customer-specific price from Shopware, including advanced pricing and price plugins. The price line stays empty for a moment and is then loaded.                    |

Live prices work in Shopping Experience elements, in the Conversion Booster, in the offcanvas cart, in the customer account and in the bundle/set configurator. **They do not work on the cart page.**

Each group of products shown needs one extra request to your shop. If "Show Price" is switched off in the element, no price is loaded.

Switch live prices on if you work with customer group prices, price tiers or B2B prices and want the card to show exactly the price the customer will pay.

<figure><img src="https://923488348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FebcjSiStaIxyVJ83vjsL%2Fuploads%2Fgit-blob-374efefcc2ba4f54f0baad8a4ad3f7cc06219fc0%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-plugin-konfiguration.png?alt=media" alt="Plugin configuration with section navigation and settings cards"><figcaption></figcaption></figure>

## Visibility check

In the plugin configuration, card "Visibility", you find the switch **"Only show products the customer may see"**. It is **on** by default.

Before display, Cross Selling Pro checks every recommendation against Shopware:

* Is the product active?
* Is it visible in the sales channel (at least "via link")?
* Is the customer group allowed to see it?
* Does another plugin hide it, for example "only for logged-in customers"?

Products that are not visible are hidden. The check costs one extra request per recommendation block. If live prices are switched on, the same request also delivers the prices.

If the check fails for some reason, all products are shown as without the check.

{% hint style="warning" %}
The visibility check does **not check stock**. You control out-of-stock products in the template (see next section).
{% endhint %}

## Out-of-stock products

How out-of-stock products are handled depends on the source of the template.

| Source                             | Behaviour                                                                                                                                                                                                                                                                                                                                                                                                       |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| InsightSearch (default)            | The stock status comes from the product feed or the data transfer and follows availability in Shopware (including clearance sale and minimum purchase). A product with variants counts as available if one variant is available. In the template, "Prefer products in stock" moves available products up; out-of-stock products remain possible. The rule building block "Only in stock" hides them completely. |
| Dynamic product stream             | Only orderable products appear. Products without the "Clearance sale" checkbox stay in even with stock 0, because Shopware keeps selling them.                                                                                                                                                                                                                                                                  |
| Bundle/set template, cross-selling | only with "Show only available products" in the set template. With the source "Dynamic product stream" in the set this always applies.                                                                                                                                                                                                                                                                          |

More about the rules on the page [Filters and rule builder](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/filters-and-rule-builder.md).

## Display on mobile devices

Below 768 px screen width, the mobile rules apply everywhere:

* **Shopping Experience sliders:** swiping with a finger, the number of cards depends on the width. The grid shows two columns below 576 px, Spotlight goes down to one column, in the mosaic tiles and text are shown below each other.
* **Offcanvas cart and cart page:** separate switches for mobile devices at the placement, see [Placements and appearance](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/placements.md).
* **Conversion Booster:** the grid of alternatives has one to four columns depending on the width.

## Read more

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

{% content-ref url="/pages/NpS6UuPrr6DqxFgdMPmA" %}
[Shopping experience elements](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/shopping-experience-elements.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/R4ryPjO5ox01iI39KIJG" %}
[Troubleshooting and FAQ](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/troubleshooting-and-faq.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/images-prices-and-fallbacks.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.
