> 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/preview-and-sandbox.md).

# Preview and sandbox

How to check a template with the preview and the recommendation sandbox before it appears in the shop.

Before a template appears in the shop, you should see which products it delivers. There are two tools for this: the preview directly in the template and the recommendation sandbox in the plugin dashboard. Both calculate with your real product data, but change nothing in the shop and do not count towards your monthly request quota.

## Preview or sandbox?

|                | Preview                                                                | Recommendation sandbox                                                                |
| -------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Where          | in the template, card “Preview”                                        | sidebar **Products & data → Products**                                                |
| Purpose        | quickly check what a template delivers and how much each rule excludes | compare templates and types, try out single values, see why a product was recommended |
| A/B comparison | no                                                                     | yes                                                                                   |
| Saves anything | no                                                                     | no                                                                                    |

## The preview in the template

The “Preview” card sits at the bottom of the template form. It only appears once the template has been saved. From then on it calculates with the current values in the form, including changes you have not saved yet. This lets you try out filters and weights before saving.

### How to use the preview

1. Open a saved template under **Delivery → Recommendation templates**.
2. Scroll to the “Preview” card. It shows what is used for the calculation, for example “From the template: …, 6 products.”
3. Depending on the type, choose a “Reference product” or a “Customer” (see table).
4. If there are several data sources, choose the right one in the “Index” field.
5. Click “Refresh preview”. After each change to the template, click again to see the new result.

| Recommendation type                                                                                                 | Selection                                                  |
| ------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| “Similar products (alternatives)”                                                                                   | “Reference product”                                        |
| “Goes well with (frequently bought together)”                                                                       | “Reference product” (optional)                             |
| “You may also like”, “Recently viewed”, “Continue where you left off …”, “Buy again …”, “Inspired by your wishlist” | “Customer”                                                 |
| “Bestsellers”, “Trending now”                                                                                       | no selection needed (“No selection needed for this type.”) |

The preview shows as many products as the template's “Limit”, but at most 24.

{% hint style="info" %}
The preview is only available for the source “InsightSearch API”. With a shop source such as “Dynamic product stream” it reports “The preview is only available for the InsightSearch source. …”
{% endhint %}

### Reading the result

**Funnel:** a line such as “198 products in the index · 194 match the rules · 6 shown” tells you how many products each stage leaves. Without rules, the middle part is omitted. If hardly anything is left at “match the rules”, the filters are too strict.

**What the calculation did:** under “Applied:” you see all filters that took effect. In addition there are notes such as:

| Note                                                                       | Meaning                                                             |
| -------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| “Mode “Same category” was dropped: the reference product has no category.” | The mode could not be applied.                                      |
| “Relaxed: parent category instead of exact category”                       | There were too few hits, InsightSearch added the parent category.   |
| “Relaxed: same type group instead of same type”                            | The product type was relaxed.                                       |
| “The calculation used the older method (fallback). The result may differ.” | InsightSearch used the previous calculation method as an exception. |

**Rule diagnostics:** if the template has rules, a table shows for each rule:

| Column            | Content                                                                                        |
| ----------------- | ---------------------------------------------------------------------------------------------- |
| “Rule”            | the rule                                                                                       |
| “Resolved value”  | the value actually used; with “Use reference product value”, the value of the selected product |
| “Matches (alone)” | how many products match this rule on its own                                                   |
| “Impact”          | “narrows by …”, “widens by …” or “no impact”                                                   |

Rules that could not be evaluated are listed under “Unevaluable rules”, for example when the reference product lacks the value to compare. The diagnostics cover the first 20 rules. The same match counts also appear directly next to the rules in the rule builder.

### Preview messages

| Message                                                                        | What to do                                                                                                                                                                                        |
| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| “Credentials missing. Please check the connection.” / “Credentials invalid. …” | check the connection in the plugin dashboard                                                                                                                                                      |
| “No index found for this template.”                                            | check data sources and language mapping                                                                                                                                                           |
| “The index is not ready yet.”                                                  | wait until the product data has been read in                                                                                                                                                      |
| “Reference product not found in the index.”                                    | choose another product or read in the product data again                                                                                                                                          |
| “The rule tree is too complex.”                                                | simplify the rules or nest them less deeply                                                                                                                                                       |
| “Too many preview requests. Please wait a moment.”                             | wait briefly and refresh again                                                                                                                                                                    |
| “No products matched these rules.”                                             | relax the filters, see [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) |

## The recommendation sandbox

You find the sandbox in the sidebar under **Products & data → Products**. It is an embedded page from your InsightSearch account and calculates live against your product data. It saves nothing and has no effect on the shop.

### Steps

1. **Choose a source product:** type a product number or title and accept a suggestion. For variants a selection list appears.
2. **Choose a template or type:** your recommendation templates are listed at the top, the recommendation types without a template below. With a template, the sandbox calculates with its type, settings, filters and product type, just like the shop.
3. **Adjustments (optional):** the fields below override individual values of the template. Empty fields keep the template's value.
4. **Test single or compare:** in the A/B comparison, configuration B uses another template or the same settings as configuration A with individual changes. The evaluation shows how many products are identical, how many kept their position and which settings differ.
5. **Why recommended:** for each product, the sandbox shows the share of every signal (brand, category, price, AI similarity, popularity, shopper behaviour, boosters) and the origin, for example same category or frequently bought together.
6. **Diagnostics:** which filters were applied, which were dropped and whether “Same category” was relaxed.

{% hint style="info" %}
If your templates do not appear in the selection, open the template, switch on expert mode and click “Copy for sandbox” under “3. Weighting”. Paste the values into “Template configuration” in the sandbox.
{% endhint %}

## Going live with little risk

1. Create the template, save it and check it in the preview with two or three typical products.
2. Compare it against the previous template in the sandbox (A/B).
3. Under “5. Display”, set a fallback threshold and a fallback, for example a bestseller template, so the block never stays empty.
4. First embed the template in a place with little traffic, for example in a Shopping Experience that is not assigned yet or in one sales channel only. Placements can be configured per sales channel.
5. After going live, watch the [statistics](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/statistics.md).

## 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/bOsKhfEoKG9Mcf9pbuHy" %}
[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)
{% endcontent-ref %}

{% content-ref url="/pages/OxFN5VKGROb1uxX81J2Q" %}
[Weighting, diversity and boosters](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/weighting-and-boosters.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/preview-and-sandbox.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.
