Smart Search Revolution: setup and help

Upload and install mprsearchrevolution, then click Configure. Open Search Revolution > Settings > Configuration for the main form. Keep a known product name and reference ready for testing.

The module normally enhances existing theme inputs. Leave Render Own Search Widget off if your theme already has a search box. Set Search Input Selector to the actual desktop and mobile inputs. For example:

.header-search input[type="search"], .mobile-search input[name="q"]

The settings are divided between Configuration, Display, Optimization, Analytics and SEO screens. They are not all on a single Settings page.

In Search Revolution > Settings > Configuration:

• Enable Module. Turns the front-office search replacement on or off; default: true.
• Render Own Search Widget. Outputs the module's own search box on displayTop/displaySearch; default: false.
• Search Input Selector. Enter selectors for your actual theme search inputs. The default covers #search_widget, #mpr-search-widget, input[name="s"], input.search-input, #search_query and text/search inputs inside .search-widget.
• Minimum Characters. Minimum query length before live search starts; default: 2.
• Debounce Delay (ms). Delay after typing before sending an AJAX request. Default: 250 milliseconds. Increase it if you want fewer requests while typing.
• Maximum Results. Maximum results shown per autocomplete section; default: 10.
• Show Bestsellers on Focus. Shows bestselling products before the visitor types; default: true.
• Bestsellers Count. Number of bestsellers shown on focus; default: 6.
• Use Full Results Layout on Focus. Shows the full dropdown layout with history, suggestions, and categories instead of a simplified bestseller view; default: false.
• Full Results Minimum Characters. Minimum characters before the full dropdown layout appears on focus, where 0 means immediately; default: 0.
• Enable Fuzzy Search. Allows typo-tolerant matching; default: true.

Use Default Section Order, Knowledge Base Section Order, Blog Section Order and FAQ Section Order to order result sections. The defaults start with products normally, knowledge-base articles in the knowledge-base context, blog articles in the blog context and FAQs in the FAQ context. The provider module must be present to supply its content.

Replace Native Search is on by default and has no field on the current main form. There is no Search Form Selector setting. With a custom theme, test both normal form submission and the dropdown to check that the native search is replaced.

Open Search Revolution > Display > Result Types.

Products

• Show Products. Shows product results; default: true.
• Show Image. Shows product images in search results; default: true.
• Show Price. Shows product prices; default: true.
• Show Reference. Shows product references/SKUs; default: false.
• Show Short Description. Shows product description excerpts; default: false.
• Description Length. Maximum product description excerpt length; default: 100.
• Show Default Category. Shows the product's default category; default: true.
• Show Category Tree. Shows a clickable category breadcrumb for products; default: false.
• Category Tree Max Depth. Maximum category breadcrumb depth for products; default: 3.
• Show Stock Status. Shows in-stock/out-of-stock badges; default: false.
• Show Stock Quantity. Shows exact stock quantity; default: false.
• Show Sales Count. Shows product sales count for a recent period; default: false.
• Sales Period (days). Period used for product sales count; default: 30.
• Image Hover Gallery. Cycles through product images on hover or first mobile tap; default: false.
• Highlight Search Matches. Highlights matching text in product names; default: true.
• Show Match Reasons. Shows feature or attribute values that explain why a product matched; default: true.
• Excluded Features. Comma-separated feature IDs hidden from match reasons and filters; default: empty.
• Excluded Attribute Groups. Comma-separated attribute group IDs hidden from match reasons and filters; default: empty.

Enable additional product details when customers need them. Leave stock quantity, sales counts and descriptions off when you do not want these details in the dropdown. Excluded feature IDs and attribute-group IDs hide those fields from match explanations and filters.

Categories

• Show Categories. Shows category results; default: true.
• Show Image. Shows category images; default: true.
• Show Category Path. Shows category breadcrumb paths; default: true.
• Show Product Count. Shows product counts for categories; default: true.
• Show Sales Count. Shows sales counts for category results; default: false.
• Sales Period (days). Period used for category sales counts; default: 30.
• Show Description. Shows category description excerpts; default: true.
• Description Length. Maximum category description excerpt length; default: 120.

CMS Pages and Manufacturers/Brands

• Show CMS Pages. Shows CMS page results; default: true.
• Show CMS Category. Shows the CMS category name; default: true.
• Show Content Excerpt. Shows a CMS content excerpt; default: true.
• Excerpt Length. Maximum CMS excerpt length; default: 120.
• Show Manufacturers/Brands. Shows manufacturer/brand results; default: true.
• Show Logo. Shows manufacturer images/logos; default: true.
• Show Product Count. Shows product count for each brand; default: true.

Supplier search retains its default image and product-count display, but the current Result Types form has no separate supplier settings group. There are no Show Suppliers, Supplier Show Image or Supplier Show Product Count fields here.

Suggestions and account shortcuts

• Show Suggestions. Shows popular query suggestions; default: true.
• Suggestions Count. Maximum suggestions shown; default: 6.
• Preview on Hover. Shows suggestion result previews on desktop hover or first mobile tap; default: true.
• Show Zero-Result Suggestions. Shows alternative suggestions when no products match; default: true.
• Show Popular on Zero Results. Shows popular searches when no products match; default: true.
• Show Account/Service Shortcuts. Shows quick links for order, tracking, invoices, returns, account login, and contact searches; default: true.
• Account/Service Shortcuts Limit. Maximum service shortcuts shown for one query; default: 3.
• Order Intent Keywords. Words that trigger order/account order shortcuts; default: order, order number, order reference, commande, numero commande, numéro commande, reference commande, référence commande, ma commande, mon colis.
• Tracking Intent Keywords. Carrier and delivery words that trigger tracking shortcuts; default: tracking, track, shipment, shipping, delivery, fedex, dhl, ups, gls, dpd, colissimo, chronopost, transporteur, livraison, expedition, expédition, suivi, suivre, colis.
• Account Intent Keywords. Words that trigger account/login shortcuts; default: account, login, sign in, my account, compte, mon compte, connexion, se connecter, identification.
• Returns Intent Keywords. Words that trigger returns and after-sales shortcuts; default: return, returns, refund, exchange, retour, retours, remboursement, echange, échange, sav.
• Invoice Intent Keywords. Words that trigger invoice shortcuts; default: invoice, invoices, credit slip, facture, factures, avoir, avoirs.
• Contact Intent Keywords. Words that trigger contact/support shortcuts; default: contact, help, support, customer service, aide, assistance, service client, nous contacter.

Change intent keyword lists to match the words customers use in each language. Account shortcuts lead to account/service pages. They do not remove those pages' login and ownership requirements.

Open Search Revolution > Optimization > Relevance.

• Exact Match. Relevance multiplier for exact field matches; default: 3.0.
• Prefix Match. Relevance multiplier when a field starts with the query; default: 2.0.
• Contains Match. Relevance multiplier when a field contains the query; default: 1.0.
• Fuzzy Match. Relevance multiplier for typo-tolerant matches; default: 0.6.
• Variant Match. Relevance multiplier for singular/plural or variant matches; default: 0.8.
• Default sort - date tiebreaker. Chooses newest or oldest when relevance and sales count are tied; default: newest.

The date-tiebreaker label contains a dash between “Default sort” and “date tiebreaker” in the Back Office. Choose newest or oldest only for tied relevance and sales counts.

Use Analytics > Search Simulator to inspect query behavior and field weights. Initial weights are:

name=6.0
reference=8.0
ean13=8.0
upc=8.0
description_short=3.0
description=1.0
manufacturer=2.0
category=2.0
tags=4.0

Search also matches configured product attributes, features and supplier data. Compare exact product names, references, synonyms and a typo before changing relevance values. The stored fuzzy threshold defaults to 0.7; higher values are stricter. It is not a separate visible field in the current main form.

Use Optimization > Exclusions to exclude selected products or incomplete catalogue entries. The no-image, no-category, no-description and no-price filters default off. Enable them only after reviewing the products they would remove.

Open Optimization > Synonyms. Set Main Term, Synonyms, Bidirectional, Active and optional Limit to Specific Items. Synonyms are language and shop aware. Test the intended direction and scope.

Import CSV without a header row. Each row is a group:

sofa,couch,settee
trainers,sneakers,running shoes

Open Optimization > Redirects for exact normalized terms. Redirect sale to a category ID, or use a query replacement such as couch to sofa. Use Search Patterns for reusable formats. Available placeholders include {N} for numbers, {W} for letters, {A} for alphanumerics, {*} for arbitrary characters, {S} for non-space characters and {D} for decimal numbers.

For example, match {N}x{N} or {N} x {N}, choose a URL redirect to /custom-size, enable captured parameters and name them width and height. A full match for 800x900 can produce /custom-size?width=800&height=900.

Open Optimization > Boosting to add query-specific product/entity relevance points or a pinned position. For example, use a query shower tray, boost points 100 and position 1 for a selected group. Verify the final order in the simulator and storefront. A boost does not create catalogue content that cannot otherwise be loaded.

Open Search Revolution > Optimization > Dimension Search.

• Enable Dimension Search Enhancements. Detects size searches and can show nearby sizes or custom-size recommendations; default: true.
• Show Nearby Catalog Sizes. Suggests nearby dimensions from active product names when exact results are missing; default: true.
• Show Nearby Sizes as Products. Renders real product cards for nearby sizes when possible; default: true.
• Nearby Suggestions Limit. Maximum nearby dimension suggestions; default: 5.
• Nearby Section Title. Multilingual title above nearby size suggestions; default: Nearby sizes.
• 2D Product Keywords. Optional product-name keywords used to limit width x length catalog scanning; default: empty.
• 2D Suggestion Label Template. Label template for 2D nearby suggestions; default: {dimension}.
• 2D Suggestion Search Template. Search term used when a 2D suggestion is clicked; default: {dimension}.
• 2D Suggestion Meta Text. Meta text for 2D nearby suggestions; default: Nearby catalog size.
• 2D Suggestion Badge Text. Badge text for 2D nearby suggestions; default: size.
• Single-Length Product Keywords. Optional product-name keywords used to limit single-length catalog scanning; default: empty.
• Single-Length Query Keywords. Keywords that allow a bare number to be treated as a length; default: empty.
• Length Suggestion Label Template. Label template for single-length nearby suggestions; default: {dimension}.
• Length Suggestion Search Template. Search term used when a length suggestion is clicked; default: {dimension}.
• Length Suggestion Meta Text. Meta text for length suggestions; default: Nearby catalog length.
• Length Alternative Meta Text. Text shown when a width x length query also suggests a single-length family; default: Alternative with nearby length.
• Length Suggestion Badge Text. Badge text for length suggestions; default: length.
• Show Custom-Size Recommendation. Shows a custom-size banner for matching dimension queries; default: true.
• Custom-Size Intent Keywords. Keywords that show the custom-size banner even without a numeric dimension; default includes bespoke, custom size, made to measure, sur mesure, mesure, configurateur, dimension personnalisée.
• Fallback Custom-Size URL Template. Multilingual fallback URL for custom-size banners; default: empty.
• 2D Custom-Size URL Template. URL template for width x length searches; default: empty.
• Single-Length Custom URL Template. URL template for single-length searches; default: empty.
• Auto-Use MPR Bespoke URL. Uses mprbespoke configurator links when that module is installed and no URL template is set; default: true.
• Fallback Custom-Size Banner Title. Multilingual title template for custom-size banners; default: Configure custom size {dimension}.
• 2D Custom-Size Banner Title. Optional title for width x length recommendations; default: empty.
• Single-Length Custom Banner Title. Optional title for single-length recommendations; default: Configure custom length {dimension}.
• Fallback Custom-Size Banner Type Label. Multilingual type label for custom-size recommendations; default: Custom size.
• 2D Custom-Size Banner Type Label. Optional type label for width x length recommendations; default: empty.
• Single-Length Custom Banner Type Label. Optional type label for single-length recommendations; default: Custom length.
• Minimum 2D Width (mm). Lower width bound for 2D custom-size banners, where 0 means no lower bound; default: 0.
• Maximum 2D Width (mm). Upper width bound for 2D custom-size banners, where 0 means no upper bound; default: 0.
• Minimum 2D Length (mm). Lower length bound for 2D custom-size banners, where 0 means no lower bound; default: 0.
• Maximum 2D Length (mm). Upper length bound for 2D custom-size banners, where 0 means no upper bound; default: 0.
• Minimum Single Length (mm). Lower bound for single-length custom-size banners, where 0 means no lower bound; default: 0.
• Maximum Single Length (mm). Upper bound for single-length custom-size banners, where 0 means no upper bound; default: 0.

Use real catalogue naming conventions in the 2D and single-length keyword fields. The nearby-size scan uses active product names. A bare number needs suitable single-length query keywords before it can be treated as a length.

For example, set 2D Suggestion Label Template to Shower tray {dimension} and 2D Suggestion Search Template to shower tray {dimension}. A custom 2D URL can use /custom-shower-tray?width={width}&height={height}&q={query}. Supply a destination URL or verify the optional mprbespoke integration. A recommendation is a link to your configurator, not a product made automatically by search.

Open Search Revolution > Display > Appearance.

• Dropdown Width. Dropdown width mode: auto, full, or fixed; default: auto.
• Dropdown Max Width (px). Maximum dropdown width in fixed/auto layouts; default: 800.
• Product Columns. Number of product columns in the dropdown; default: 1.
• Product Columns (Wide Screens). Product columns above the wide breakpoint; default: 2.
• Wide Screen Breakpoint (px). Screen width for wide layout; default: 1200.
• Enable Load More. Uses a load-more button instead of showing every product at once; default: true.
• Initial Results Count. Products shown before load more; default: 12.
• Load More Count. Products added per load-more click; default: 6.
• Primary Color. Main accent color for buttons, links, and highlights; default: empty, auto-detected when possible.
• Primary Hover. Hover color for primary elements; default: empty, auto-computed when possible.
• Text Color. Main text color; default: empty.
• Muted Text. Secondary text color; default: empty.
• Background Color. Main background color; default: empty.
• Border Color. Border color for cards, inputs, and dividers; default: empty.
• Border Radius. CSS border-radius value; default: empty.
• Success Color. Color for in-stock and success indicators; default: empty.
• Danger Color. Color for out-of-stock and error indicators; default: empty.
• Font Family. CSS font-family for module UI; default: empty, inherited from theme.

Use the layout values to adjust the dropdown and incremental results. The old Search Page Layout selector is absent from the current form. Check the full listing against your theme's available columns and listing templates.

The Appearance screen also includes shared theme styles. Leave colors empty to use the available theme detection and inheritance. Add CSS in your theme stylesheet when you need a targeted adjustment:

.mpr-sr-search-container .mpr-sr-dropdown { border-radius: 6px; }
.mpr-sr-page-product-name mark, .mpr-sr-match { background: #fff3cd; }
.mpr-sr-page-loadmore-btn { min-width: 180px; }

Open Search Revolution > Analytics > Tracking Settings.

• Enable Analytics. Tracks search query behavior; default: true.
• Track Clicks. Tracks clicked search results; default: true.
• Track Conversions. Marks tracked search clicks as converted when the clicked product is later purchased; default: true.
• Adaptive relevance ranking. Uses clicks, CTR, and conversions to reorder products that already match the query; default: true.
• Behavior lookback days. Number of recent days used for adaptive ranking; default: 90.
• Exact-query click weight. Ranking points added for clicks from the same query; default: 2.5.
• Related-query click weight. Ranking points added for clicks from refined or related queries; default: 0.8.
• Conversion weight. Ranking points added for tracked purchases after a search click; default: 7.5.

Passive query retention days defaults to 90. Use it to bound passive query history. Clicks and conversions contribute to adaptive ranking only when the relevant tracking and matching purchase attribution are available. View Search Queries and the Dashboard after real test activity.

Open SEO > SEO Pages to create a landing page. Fill Search Query, URL Key, Indexable, Active, Meta Title, Meta Description, H1 Title, Short description (top intro) and Description (long, below products). For example, use query black shower tray and key black-shower-tray.

Use the generated page link for your shop and language. Localized search route prefixes include English search/results, German suchergebnisse, French resultats-de-recherche, Polish wyniki-wyszukiwania, Italian risultati-di-ricerca and Spanish resultados-de-busqueda. A URL key is the page segment, not the entire route.

The module can add active indexable SEO pages through gSitemapAppendUrls. Sitemap inclusion is on by default (1) and has no separate field on the current main form. Check your installed sitemap provider and generated sitemap. Keep thin or unfinished pages non-indexable.

Most defaults below are runtime options without fields on the settings forms. AI Search, AI Provider, AI API Key and AI Model are available in Settings > Configuration, alongside provider, model, call-limit and spending settings. AI search is disabled by default; the other runtime options below remain integration settings.

• Recently Viewed. Shows recently viewed products in the search experience; default: true.
• Recently Viewed Limit. Number of recently viewed products shown; default: 6.
• Buy Again. Shows previously purchased products for logged-in customers; default: true.
• Buy Again Limit. Number of buy-again products shown; default: 4.
• Recommendations. Shows recommended products; default: true.
• Recommendations Limit. Number of recommendations shown; default: 4.
• Sync History. Syncs search history across devices for logged-in customers; default: true.
• Voice Search. Enables browser voice-search controls when available; default: false.
• Voice Search Language. Browser speech-recognition language, or automatic detection; default: auto.
• AI Search. Enables optional AI-assisted search endpoints when configured; default: false.
• AI Provider. AI provider used by the optional AI search feature; default: claude.
• AI API Key. API key for the optional AI provider; default: empty.
• AI Model. Explicit AI model override; default: empty.
• External API. Enables the module's external API controller; default: false.
• API Allowed Origins. CORS origin list for external API calls; default: *.

The external API requires a valid Bearer token with endpoint permissions. Allowed origins alone do not authorize access. Browser voice recognition depends on browser support. AI requests need a configured provider endpoint and model. Anthropic requires an API key; an OpenAI-compatible server can work without a key if it allows unauthenticated requests. The saved disabled defaults do not make AI search operational.

Other modules register descriptors through actionMprSearchRevolutionRegisterContentProviders. The registry uses provider API version 2 and runs each descriptor's search callback. Install and test the content provider before adding its section ID to the order. Do not use the old actionMprSearchRevolutionRenderSections hook to register providers. Express checkout controls require the compatible mprexpresscheckout module.

1. Run Settings > Integrity.
2. Type a known product name, reference and typo. Confirm requests reach the module AJAX controller and the intended product appears.
3. Test desktop and mobile fields, keyboard navigation and normal form submission.
4. Test one synonym, exact redirect, structured pattern and boost independently.
5. Open the full results page. Test sorting, price/stock/discount filters, feature/attribute filters and incremental results supported by your theme.
6. Open one active SEO page in each configured language. Check H1, metadata, robots and sitemap inclusion.
7. Click a result and validate a test purchase. Check analytics without assuming every click becomes a conversion.

If the dropdown does not appear, check Enable Module, Search Input Selector, minimum length, browser errors and loaded assets. If a product is missing, inspect shop/language visibility, exclusions, catalogue data and simulator results. Tighten typo matching or add a synonym when vague queries rank poorly. Temporary disabling preserves analytics data; uninstall is a separate operation.

Back up queries, synonyms, redirects, patterns, boosts, SEO pages and settings first. Uninstall removes module admin tabs, front-controller page records and its schema, and unregisters its shared holiday usage. Do not expect analytics data to survive. Restore or re-enable the theme's native search integration and retest search submission. Replace any inbound links to removed SEO search pages.

Requires PrestaShop 1.7.0 or later and PHP 7.1 or later.