Settings and templates

The widget configuration is stored on the server and the widget picks it up at start-up. A change takes effect without touching the e-shop code and without a deployment.

Display mode

mode	behaviour
dropdown	the panel expands below the e-shop's search input; that input stays the only one
modal	results open across the whole screen and the panel has its own search input

On mobile devices dropdown behaves as a bottom sheet pinned to the bottom edge: the search input stays in place and only the panel content scrolls.

Templates

A template is always a pair of layout and theme, for example standard-soft.

The layout determines the panel's features and arrangement:

layout	for	contains
Mini	a narrow input, limited space	a compact product list, categories as pills
Standard	a regular e-shop	image, name and price, a list/grid toggle, a button to reveal more results
Pro	a full result surface	filters (price, categories, facets), sorting, paging, product code on the card
Max	Standard and Pro in one widget	the customer switches between quick and extended search

The theme defines the appearance only — colours, typography and spacing. The universal themes are Soft (branded, with the Metty accent) and Flat (plain and restrained). For an e-shop with its own design we can prepare a bespoke theme that adopts its colours and typography.

Layout and theme are independent, so Standard Soft and Standard Flat behave identically and differ only visually.

Max — quick and extended search

Max is a single widget covering both the dropdown under the search input and a complete result page:

• it opens in the quick (Standard) view with a product list and categories,
• the “Extended search” toggle switches to the Pro view with filters, catalog facets, sorting and paging,
• the “Back to quick search” toggle returns to the original view with the query preserved.

Switching back to the quick view drops the filters and the sorting: the quick view neither shows them nor offers a way to clear them, so they would keep narrowing the results invisibly. The customer keeps only the query and gets the full result set for it again.

The e-shop therefore does not need a result page of its own.

Result counts

The number of products, categories and suggestions the widget requests is determined by the layout; it is not an e-shop level setting. Mini and Standard show a compact selection, Pro works with a wide selection and pages through it in the browser.

How many products the first page holds is decided by the layout as well, and each layout uses a shorter list on mobile:

layout	desktop	mobile
Mini	10	6
Standard	6 per batch	4 per batch
Pro	15 per page	5 per page

In the Pro view the visitor can raise the page size to 30 or 60 in the widget itself. The e-shop has no say in any of these numbers: they belong to the layout and are the same for every e-shop and every theme.

Appearance

Appearance is not configured per e-shop at runtime. Colours, typography, spacing, corner radius and what a product card shows — the product code and the stock status included — are part of the theme and are built into the widget bundle. The widget does not take any of them from the server-side settings, so they cannot be changed without a new widget release.

An e-shop that needs its own palette or font therefore gets a bespoke theme instead of an override: we prepare it from your design and it ships with the next release. The match highlight colour is part of the theme as well, so it is tuned together with the rest of its palette.

Verifying a change before it goes live

Before deployment we can prepare a preview: a link on preview.metty.eu where the widget with a specific configuration is placed on a snapshot of your site. You can judge the result without any change to the production e-shop.