> 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/search-intelligent-and-ai-optimized/search-on-mobile.md).

# Search on mobile

Search on smartphones: four mobile designs, product display, suggestions and filters in a panel from the bottom.

On small screens the search needs different solutions than on the desktop: less room for suggestions, filters that do not get in the way, and results that are visible without scrolling. For this there are four mobile designs you can choose from. Without a change, everything stays as before.

You find the settings in the plugin configuration on the card "Search configuration".

## The thresholds

Two screen widths matter:

* **Below 768 pixels** the mobile designs, the product display and the number of suggestions for mobile devices apply.
* **Below 992 pixels** the setting "Filters on mobile devices" applies. With a new mobile design it applies in the search window only between 768 and 991 pixels.

The 768 pixel threshold is determined when the page opens. If a customer then resizes or rotates the window, an already open search window does not change.

The mobile designs have no effect in the layout "Native Shopware design", because there is no plugin search window there.

## Design on mobile devices

Setting: "Design on mobile devices" (default: "As before").

| Design          | Description                                                                                                                                                                                                            | Recommendation                                                      |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| "As before"     | The previous display: suggestions as selection buttons, filters according to the setting "Filters on mobile devices".                                                                                                  | If you do not want to change anything.                              |
| "Compact bars"  | Suggestions sit in one row to swipe. Filters open via a button "Filter" with the number of active filters; active filters sit in their own row. The filters open in a panel from the bottom.                           | A good middle way for most shops with filters.                      |
| "Results first" | Suggestions appear only if there are no results. Filters open via a fixed button at the bottom, active filters sit at the top.                                                                                         | If customers should mainly see products quickly.                    |
| "App style"     | At most 3 suggestions as plain text lines, below them a swipeable row with one button per filter group (for example "Brand (2)" when two brands are selected). A tap opens only this group in a panel from the bottom. | Shops with clearly structured filters that should feel like an app. |

With the three new designs the header area is more compact. **Categories, pages and banners (from a search term rule) as well as the hint for a relaxed search sit below the products**, so that the results are visible without scrolling.

The new designs show filters only if "Enable filter rendering" is on.

## Products on mobile devices

Setting: "Products on mobile devices" (default: "Automatic as before").

| Choice                  | Effect                                                                                                                                                                                          |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "Automatic as before"   | The grids (detailed and compact) become a list on mobile. "Compact list" and "Carousel" stay as they are.                                                                                       |
| "List"                  | Compact list for every layout, including the carousel.                                                                                                                                          |
| "Grid with two columns" | Two fixed columns with standard cards, square image, name at most two lines, only the first badge, no quick view button, smaller rounding. The subtitle stays, the cart button stays (smaller). |

**Recommendation:** The two-column grid shows many products at a glance and suits image-driven ranges. The list is better when names are long.

## Number of suggestions on mobile devices

Setting: "Number of suggestions on mobile devices" (default: empty, allowed 0 to 10).

* **Empty:** same as "Number of search suggestions".
* **0:** no suggestions as long as there are results.
* **1 to 10:** this number.

If there are no results, all suggestions stay, because they are then the best help. A hint about a typo always stays visible. "Results first" limits the suggestions to 0, "App style" to at most 3, even with a higher setting.

## Filters on mobile devices

Setting: "Filters on mobile devices" (default: "Show as before"). It applies to screens below 992 pixels and, as long as a mobile design is chosen, in the search window only between 768 and 991 pixels.

* **"Show as before":** The filters sit in the window above the results.
* **"Collapse behind a filter button":** The results come first. A button "Filter", with the number of active filters such as "Filter (2)", opens the filters.
* **"Hide":** There are no filters in the window. Active filters stay visible as removable selections with "Reset". On Shopware's search results page, the button "Filters" then disappears as long as no filter is active.

## The filter panel from the bottom

With the new designs, the filters open in a panel that slides up from the bottom:

* Title "Filters"; with "App style" the name of the group.
* Close with "×".
* At the bottom "Reset" (only with active filters) and the button "Show 128 results", which closes the panel and names the current number of results.
* Esc closes only this panel, not the search window.
* The background does not scroll along. The focus moves to the title on opening and back to the button that opened the panel on closing.

## Further details

* The logo does not appear in the window below 768 pixels.
* With a restored search, the on-screen keyboard does not open by itself on touch devices.
* The shopping assistant shows no "Advice" button in the cart and checkout.

{% hint style="info" %}
The setting "Replace base styling with custom CSS" deliberately leaves the rules for "Filters on mobile devices" and the mobile designs untouched. A custom stylesheet therefore does not break the filter panel from the bottom or the bars. More under [Customize design](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/customize-design.md).
{% endhint %}

## Recommended start

1. Switch on "Enable filter rendering" if you offer filters.
2. Choose "Compact bars" as the design and "Grid with two columns" for the products.
3. Test the search on a real phone with a term with many results and one with none.
4. Adjust the number of suggestions if they take too much room.

## Read on

{% content-ref url="/pages/fuc5W4KYHveM2vez4IUa" %}
[Search in the shop](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/search-in-the-shop.md)
{% endcontent-ref %}

{% content-ref url="/pages/YEBvytB69E4Y4qAMmqvE" %}
[Filters](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/filters.md)
{% endcontent-ref %}

{% content-ref url="/pages/SX6VJJikEcgYUirKdc6e" %}
[Customize design](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/customize-design.md)
{% endcontent-ref %}

{% content-ref url="/pages/v20EC98NJrD47BUleH4w" %}
[Plugin settings](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/plugin-settings.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/search-intelligent-and-ai-optimized/search-on-mobile.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.
