LogoLogo
Homepage
English
English
  • Contributing to the documentation
  • Getting started with PrestaShop 1.7
    • What you need to get started
    • Installing PrestaShop
    • Installing PrestaShop on your computer
    • Installing PrestaShop using the command-line script
    • Uninstalling PrestaShop
    • Misc. information
  • User Guide PrestaShop 1.7
    • Training
    • Customizing your shop
    • Connecting to the PrestaShop back office
    • Discovering the Administration Area
    • First steps with PrestaShop 1.7
    • Selling with PrestaShop
      • Managing your Orders
        • Order list management
        • Order page management
          • Editing an order
          • Creating returns and refunds
        • Creating a back office order
        • Invoices
        • Credit slips
        • Delivery slips
        • Shopping carts
      • Managing your Product Catalog
        • Managing Products
        • Managing Categories
        • Monitoring your Catalog
        • Managing Product Attributes
        • Managing Product Features
        • Managing Brands
        • Managing Suppliers
        • Managing Files
        • Managing Discounts
          • Cart Rules
          • Catalog Price Rules
        • Managing Stock
          • Stock Overview
          • Stock Movements
      • Managing your Customers
        • Your customers
        • Customer addresses
        • Outstanding
      • Managing the Customer Service
        • Customer Service
        • Order Messages
        • Merchandise Returns
      • Understanding your statistics
    • Improving your shop
      • Managing your Modules
        • Modules and Services
          • Module notifications
          • Modules Selection
          • Installed modules
        • Module Catalog
      • Customizing your store design
        • Theme and Logo
        • Theme Catalog
        • Email Theme
        • Pages - Managing Static Content
        • Positions
        • Image Settings
        • Link Widget
      • Managing Shipping
        • Carriers
        • Shipping Preferences
      • Managing Payments
        • Payment Methods
        • Payment Preferences
      • Going International
        • Localization
          • Localization settings
          • Languages
          • Currencies
          • Geolocation
        • Locations
          • Countries
          • Zones
          • States
        • Managing Taxes
          • Taxes
          • Tax Rules
        • Translations
    • Configuring your shop
      • Configuring your Shop Parameters
        • General settings
          • General parameters
          • Maintenance
        • Order Settings
          • Orders preferences
          • Statuses
        • Product Settings
        • Customer Settings
          • Customer Preferences
          • Groups
          • Titles
        • Contact
        • Traffic
          • SEO and URLs
          • Search Engines
          • Referrers
        • Search
          • Search parameters
          • Tags
      • Configuring Advanced Parameters
        • Information
        • Performance
        • Administration
        • Email
        • Import
        • Team
          • Employees
          • Profiles
          • Permissions
        • Database
          • SQL Manager
          • Database Backup
        • Logs
        • Webservice
        • Multistore
        • Experimental features
    • Managing multiple stores
      • The multistore interface
        • Adding a new store
        • Adding a new group of stores
        • Setting a store's URL
      • Sample Usages and Specifics
    • Browsing the front office
    • Complying with the GDPR
Powered by GitBook
On this page
  • Aliases list
  • Indexing
  • Search options
  • Weight

Was this helpful?

Edit on GitHub
  1. User Guide PrestaShop 1.7
  2. Configuring your shop
  3. Configuring your Shop Parameters
  4. Search

Search parameters

PreviousSearchNextTags

Last updated 4 years ago

Was this helpful?

The "Search" page enables you to configure your shop's search features.

Aliases list

When customers make a request using your shop's internal search engine, they may make mistakes in spelling. If PrestaShop does not display the right results, the "alias" feature can address them. You will be able to take words containing spelling errors, and point them to the real products sought by customers.

To create a new useful alias, you should first find the spelling errors most often typed by your users:

  1. Go to the "Shop search" tab of the "Stats" page, under the "Stats" menu. You can see the words typed by your customers as well as the most frequent errors.

  2. Take the most frequent ones, and add them to your list of aliases, in order to point users to the correct products.

  3. Click the "Add new alias" button on the "Search" parameters page.

The creation form is very straightforward: indicate the typo you want corrected, and the correct word it should lead to.

For instance, let's say your visitors frequently type "player" as "palyer" and "plaier". You can create an alias for each of these typos, which will match the word "Player". Your aliases can be used as soon as they are saved.

We also invite you to consult the sections of this guide on product and category meta tags, to better understand how to display products based on words typed by your customers.

Indexing

This section provides information on the number of products that can be searched through your shop's search function, and compares it to the number of products present in your catalog. If the values do not match, you must click the "Add missing products to the index" link. Only the new products will be indexed. If you have made several changes to already indexed products, you might prefer to choose to re-build the whole index. The "Re-build entire index" process takes more time, but it is more thorough.

PrestaShop also gives you the URL to let you create a cron task for regular re-building of the index. If you do not know about cron and crontab, ask your web host about it.

Finally, the "Indexing" option enables you to have a product be indexed as soon as it is created/modified, thus rending the above links and cron link useless.

Search options

This section enables you to configure the behavior of your shop's search function:

  • Search within word: This option improves search by allowing the customer to make queries that do not only match the start of the search word; for instance, "lou" for "blouse".

  • Search exact end match: With this option, the search can give results that will match exactly the end of the search word. For instance, if a customer searches "book", they will see "notebook", but not "bookcase"

  • Fuzzy search: This feature improves the PrestaShop search functionality by taking into account misspelling or error inputs. For instance, if a customer enters 'ummingbird' in the search bar, the search controller will find the closest word, i.e. 'hummingbird', and display the relevant products.

  • Maximum approximate words allowed by fuzzy search: You can determine how many words a query can handle in a fuzzy search. By default, the value is set to 4. It means that in a search like ‘Samsung Galaxy wall charger multiplug’, only the ‘Samsung’, ‘Galaxy, ‘wall’, and ‘charger’ words will be taken into account. ‘Multiplug’ will not be computed.

Note that PrestaShop sets that limitation in order to avoid offensive behaviors that could overstress the server intentionally. You can modify this number, but most stores will not have to do so.

  • Maximum word length (in characters): This option defines how many characters you allow to run a fuzzy search query. We advise setting the maximum word length at 15 to keep the fuzzy search fast, even when processing long queries. This will not prevent your customers from entering longer words in the search bar, but only the first 15 characters of each word entered will be taken into account for the search. For example, in "thisisaverylongword (19 char.) only "thisisaverylongw" (15 char.) will be taken into account. When modifying the maximum word length, keep in mind that the longer the word (in characters), the more stressed the server is. So, the larger your database is, the more resources a search will consume and the longer it will be.

  • Minimum word length. You can choose the minimum size at which a word may be registered in the search index and found by your customers. This feature allows you to eliminate short words in the search, such as prepositions or articles (the, and, of, etc.).

  • Blacklisted words. You can choose the terms that must not be found by your visitors. Enter them directly into the field, separated by "|" ("pipe" character, not lowercase L). By default, PrestaShop fills the list with common short words.

Weight

PrestaShop enables you to prioritize certain data when a search is performed on your shop.

As indicated in the section, the search "weight" of a product represents its importance and relevance for the ranking of the products when customers try a new search. An item with a weight of 8 will have 4 times more value than an item with a weight of 2.

For instance, by default "Product Name Weight" is at 6, "Tags weight" is at 4, and both "Short description weight" and "Description weight" are at 1. This means a product with "ipod" in its name will appear higher in the search results than another product which has "ipod" only in its tags. Meanwhile, a product which only has "ipod" in any of its description will have the lowest rank in the search results.

You have many factors that you can assign a weight to: short description, category, tags, attributes, etc. You will find that the display order of results can be reversed because you changed the weight of the various fields. Fine-tuning these settings will be more visible on a large catalog with many references.

Once your changes are saved, they take effect immediately

Fuzzy search is one of PrestaShop 1.7.7's new features. It is also the result of a community member's contribution! 😍 Check on the to get more details about this feature.

article on PrestaShop's developer blog