↑↓ selectEnter openEsc close

    1. Elbuz

    How to set up the smart search window appearance

    5 min readUpdated

    The Elbuz smart search window adapts to your site design. Size and theme, button color, list view, filters, popular blocks and card fields are set on one tab and work once you save and the page reloads.

    When you need this:

    • The search window clashes with your site — set the color, corners and “Buy” button to your brand.
    • Results are cramped below the search bar — a full-screen window fits more.
    • Shoppers need filters and popular items — blocks are turned on separately.
    • You need search on the page, not in a drop-down — an embedding rule places it anywhere.

    Where to start: the “View” tab → “Search window”.

    What you can set on the “View” tab

    • Window and theme — full screen or below the search bar, light or dark.
    • Colors — main color, corners, card size, style and effect of the “Buy” button, price colors.
    • Results — pages, grid or list, Enter, AI hints, font.
    • Buttons and blocks — what appears on the product card and in the window.
    • Embedding — search on the page without a drop-down window.
    • Your own code — styles and scripts before the window opens and after it closes.

    Everything on this tab takes effect on the site after saving, as soon as the shopper reloads the page: the form saves itself, and you don't need to rebuild the index. The exception is “Show product reviews”, see below.

    How to choose the window type and theme

    The “Search window” card.

    • “Search window display”: “Inline window below the search bar” (default) — results drop down below your site's search box; “Full-screen window” — search opens over the page in full screen. On phones the window always opens in full screen.
    • “Dark mode”: “Auto (match the site, otherwise the device)” (default), “Always light” or “Always dark”. In “Auto” the window follows the site: dark if the site is marked as dark or has a dark background, light if the background is light. The shopper's device theme applies only when the site says nothing about itself.
    The “View” tab: the search window type, dark mode, accent color and a preview of the cards
    1Window type
    2Theme
    3Main color
    4Corners and card size
    5“Buy” button
    6Preview
    1. Below the search bar or full screen.
    2. “Auto” follows the site, otherwise the shopper's device.
    3. Buttons, selected filters, links and highlights.
    4. Compact cards fit more products on screen.
    5. The button look and the hover effect.
    6. Changes instantly but approximately; the exact look is on the site.

    How to pick colors and the “Buy” button

    The “Appearance”, “Buy” button and “Colors of individual elements” cards. On the right, a “Preview” of two product cards changes instantly but shows only an approximate look. The exact look is on the site after saving.

    SettingOptionsWhat it affects
    Button and accent color“Default” (blue), 24 ready-made colors or your ownbuttons, selected filters, links and highlights in the window
    Corner roundingSharp, Normal, Softcorners of the window, cards and buttons
    Product card sizeRegular, Compact — more products on screenspacing, photos and text on cards
    Button styleFilled (default), Outline, Soft, Gradientthe “Buy” button on the card
    Hover effectColor change (default), Lift with shadow, Glow, Growhow the button reacts to the cursor

    “Colors of individual elements” set your own color for: the “Buy” button and its hover color, rating numbers and counters, the price, the sale price and discount badge, the old price, and items marked “Wishlist” and “Compare”. A pale dotted circle means the default color; click it to choose your own, and the cross resets it.

    If the cart isn't set up on the site, the “Details” button stands in place of “Buy”, and the color and style apply to it. How to connect the cart — cart, wishlist and comparison.

    How to show results

    The “Search results display settings” card.

    • “Pagination mode”: “Infinite scroll” (default) — products load as the shopper scrolls; “Load more” button; “Classic pagination” — page numbers.
    • “Product list type”: “List” (default) or “Grid”. Whether shoppers can switch it themselves is controlled by the “Change product list view” block, see below; the shopper's choice is remembered and overrides the setting. On phones products are always shown as a list.

    “More options” checkboxes:

    CheckboxWhat it does
    Apply filters with a buttonresults are rebuilt when the shopper clicks the apply button, not after every checkbox. On phones, filters are applied with a button in the slide-out panel anyway
    Show product reviewsrating and reviews on the card. Reviews get into search when the index is built: after turning this on, rebuild the index. Only published reviews from Elbuz are shown
    Use the site fontthe window uses your site's font; when off, the Manrope widget font
    Send request to AI chat when clicking “Details”when the shopper opens a product, the AI assistant in the search window receives this product, the query and the filters. Works only if the chat is embedded into the search window
    Search in all languagesthe query is searched in all catalog languages — details
    Press Enter to open the search pageEnter leads to your site's results page — requires the “Search URL template”
    Check spelling of search queries using AIthe “Did you mean:” hint; paid — what's paid
    Show refinement hints (chips) above results using AIchips that narrow the query; paid
    Determine the product color and change the frame colorif the name contains a color («чорний», “red”), the card frame is painted that color. Out-of-stock products aren't painted
    Hide text in brackets from search resultsremoves a code in brackets from the end of the name: “Dell Laptop (XPS-9530)” is shown as “Dell Laptop”. The name in the catalog doesn't change
    The “Search results display settings” and “Action buttons” cards on the “View” tab
    1Result pages
    2List or grid
    3Filters by button
    4Enter opens the site page
    5Go to the product page
    1. Infinite scroll, a “Load more” button or page numbers.
    2. How products are shown by default.
    3. Results are rebuilt by the button, not after every checkbox.
    4. Requires the search page link on the “Links” tab.
    5. “Details” leads to the site instead of the expanded card.

    Which buttons, blocks and fields to show

    Buttons on the product card

    The “Action buttons” card. By default all buttons are on except the two navigation modes.

    • “Add to comparison”, “Add to wishlist”, “Add to cart” — buttons on the card. For the product to go into your site's cart, you need code: how to connect the cart.
    • “Product details” — an expanded card right in the search window: attributes, description, photos, videos, files, delivery, payment, warranty, store contacts.
    • “Clicking “Details” opens the product page” — instead of the expanded card, “Details” leads to the product page on your site.
    • “Clicking the name shows details without following the link” — a click on the name opens the expanded card, not the product page.
    • “Share search link” — a button above the results, next to the view switch, that copies an address opening the same search with the same filters.

    Search window blocks

    The “Blocks” card. Everything is on by default except “Suggestion keywords” and the “Deals only” filter.

    BlockWhat the shopper sees
    Select product sortingby relevance, cheapest first, most expensive first, newest
    Change product list viewa “list / grid” switch
    Suggestion keywordsquery suggestions while typing
    Found categoriescategories with product counts; a click narrows the results
    “Deals only” filtera switch that keeps only discounted products in the results: with a sale price lower than the regular price, or with an old price. Only prices whose display is turned on in the “Prices” tab count. Off by default; takes effect after the index update
    Filter by price, brand, availability, attributesfilters beside the results, on phones in a slide-out panel. The attribute filter requires “Search by attributes” on the “Setup” tab; the availability filter appears only when “Search only for products that are in stock” is off
    List of all store categoriesa “Catalog” button with the category tree
    Popular queries, Popular categories, Popular productsshown until the shopper types anything

    Fields on the product card

    The “Field display” card: “Manufacturer part number (MPN)”, “Store SKU”, “Barcode”, “Warranty”, “Model”. All are off by default. A field is shown if it's filled in for the product.

    The “Blocks” and “Field display” cards: sorting, filters, popular items and product card fields
    1Sorting
    2Query suggestions
    3Filters
    4Deals only
    5Popular
    6Card fields
    1. Relevance, price, new arrivals.
    2. Off by default.
    3. Beside the results; on phones, in a slide-out panel.
    4. Keeps only discounted products; off by default.
    5. Shown until the shopper types anything.
    6. Shown if the field is filled in for the product.

    How to embed search into a page

    The “Embed search into a page” card places the search window right into a site page — for example, into the “Search” page or an empty category. The “Add rule” button adds a rule with these fields:

    • “CSS selector” of the page element where search will go;
    • “Position”: “Inside (at the end)”, “Inside (at the start)”, “Before the element”, “After the element”, “Replace the element”;
    • “URL contains” — part of the page address, for example /catalog. For several options, use a regular expression between slashes: /catalog|search/. Empty — on all pages;
    • “Height” and “Width” of the block, for example 600px and 100%.
    The “Embed search into a page” card with a rule: CSS selector, position, URL contains, height and width
    1Where search goes
    2Position
    3Which pages
    4Block size
    5Another rule
    1. The page element next to which the search window is embedded.
    2. Inside, before, after the element or instead of it.
    3. Part of the address or a /regex/; empty means all pages.
    4. The height and width of the search block.
    5. The first matching rule wins.

    A new rule is saved when you close the form window. Rules are checked in order, and the first one whose address matches and whose element is found wins. Search is embedded as a separate frame with the full search interface, while the site's regular search box keeps working as before. To remove a rule, click the cross in its corner.

    Your own CSS and JS

    The “JS, CSS settings” card — for what checkboxes can't do.

    • “CSS Styles” — added to the search window styles on your site.
    • “JS code” — runs on the site together with the widget.
    • “Run JS code before opening” and “Run JS code after closing” — for example, to hide and bring back the theme's floating buttons that cover the window.

    Choosing “CMS ID” and “CMS theme” on the “Setup” tab fills these fields with the styles and code the theme needs, and asks before replacing your code — what choosing a CMS fills in. “Run JS code before opening” fires before the search window appears on screen.

    What the shopper sees in the search window

    • Window with no query — the shopper's search history (5 latest queries), popular queries, categories and products; if “Link to promotions” is set, a “Promotions” chip.
    • While typing — results change with every letter; pale autocomplete text is accepted with Tab, arrows switch between suggestions, Esc closes the window.
    • Product card — photo, name, attributes, rating, price, old price, discount, availability and the selected fields.
    • Banners above the results — “Showing results for …”, “No exact match — showing similar products”, “The products found are currently out of stock”, “Nothing found” with a “Reset filters” button and, if the promotions link is set, “View promotions”. When each one appears — how search understands typos.
    • Voice search — a microphone button, if turned on in the “Setup” tab.
    • Phone — filters in a slide-out panel, comparison, wishlist and cart buttons at the bottom of the screen.

    Scenarios

    The search window must use brand colors

    What to do. In “Button and accent color”, choose your color; for the “Buy” button, choose “Filled” and “Lift with shadow”. Check the “Preview”, then the window on the site.

    What you get. Buttons, selected filters and highlights are in your brand color.

    Large catalog, shoppers are cramped below the search bar

    What to do. Choose “Full-screen window”, “Grid” and “Compact” cards, keep the filters.

    What you get. More products on screen, with filters alongside.

    A separate search page on the site

    What to do. Add an embedding rule: the selector of the page content area, position “Inside (at the end)”, “URL contains” — part of the search page address, for example route=product/search, height 800px. Close the form window so the rule is saved.

    What you get. On the search page, the search window sits in the page content; on other pages there's the regular search box.

    What to do when the window looks wrong

    What you seeWhyWhat to do
    The preview doesn't match the sitethe preview is approximate; on the site, theme styles and “CSS Styles” also applycheck on the site
    Theme buttons or menus cover the windowthe theme has its own elements on top of the pagehide them with code “before opening” and bring them back “after closing”
    No attribute filter“Search by attributes” is off on the “Setup” tabturn it on and rebuild the index
    No reviews on cardsreviews didn't get into the indexturn on “Show product reviews” and rebuild the index
    Embedded search didn't appearthe rule isn't saved, the address didn't match, or the page has no element matching the selectorclose the form window, check “URL contains” and the selector

    FAQ

    How do I show results in full screen instead of below the search bar?

    In “Search window display”, choose “Full-screen window”.

    How do I stop results from rebuilding after every filter checkbox?

    Turn on “Apply filters with a button”: results are rebuilt when the shopper clicks the button. On phones, filters are always applied with a button.

    Why is the font in the search window different from the site?

    “Use the site font” is off, so the window uses the Manrope widget font. Turn the checkbox on.

    Why is the window light in “Auto” mode when my system is dark?

    “Auto” looks at the site first: if it has a light background, the window stays light. The system theme applies only when the site says nothing about itself.

    Where it is and who has access

    Menu
    Directories → Categories → the “Widget settings - Smart search” tile → the “View” tab
    Access right
    the “Smart product search widget” window in “Group permissions”
    Prepare
    a widget already connected to the site

    Related topics

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free