Quand la recherche d'une boutique PrestaShop ne trouve rien, la cause est presque toujours dans le moteur natif lui-même : produit absent de l'index, produit inactif ou masqué de la recherche, mot trop court, mot cherché au milieu d'un autre, ou requête de plusieurs mots qui ne se trouvent pas tous dans le même produit. Ces réglages se trouvent dans Paramètres de la boutique > Rechercher.
Ce guide suit la documentation officielle de PrestaShop et le code du moteur de recherche (classes/Search.php) des versions 1.7.8, 8.2 et 9.2, lus le 21 novembre 2026. Il part du symptôme, donne la vérification à faire, puis la correction. Si votre recherche trouve les bons produits mais met plusieurs secondes à répondre, c'est un autre problème, traité dans notre article sur une boutique PrestaShop lente.
Comment fonctionne la recherche native de PrestaShop ?
L'index de recherche est une liste de mots tirés de vos fiches produits, stockée dans deux tables : ps_search_word (les mots, par langue et par boutique) et ps_search_index (le lien entre chaque mot, chaque produit et un poids). Quand un client tape une requête, PrestaShop ne lit pas vos fiches : il nettoie la requête, la découpe en mots, et cherche ces mots dans l'index.
Quatre règles du code suffisent souvent à expliquer une recherche vide :
- un produit n'est trouvé que s'il est actif, indexé et visible « partout » ou « dans la recherche uniquement » ;
- chaque mot doit commencer comme un mot de l'index : « chemi » trouve « chemise », « mise » ne la trouve pas, sauf réglage contraire ;
- quand la requête contient plusieurs mots, le produit doit les contenir tous ;
- les mots plus courts que la taille minimale (3 caractères par défaut) sont ignorés, à l'indexation comme à la recherche.
La barre de recherche du thème est fournie par le module Barre de recherche (ps_searchbar), y compris les suggestions qui s'affichent pendant la frappe. Elle s'appuie sur ce même moteur : si la page de résultats est vide, les suggestions le sont aussi.
Diagnostic rapide : symptôme, cause, réglage
| Ce que vous constatez | Cause probable | Où vérifier |
|---|---|---|
| Un produit récent ou importé n'est jamais trouvé | Produit absent de l'index | Rechercher > Indexation : comparer les deux compteurs |
| Un produit précis n'est jamais trouvé, les autres oui | Produit inactif, visibilité « Catalogue uniquement » ou « Nulle part », nom non traduit | Fiche produit : statut, Options > Visibilité, langues |
| « XL », « S9 » ou « T2 » ne donnent rien | Mot plus court que la taille minimale | Rechercher > Taille de mot minimum |
| Un mot ne donne rien s'il est au milieu d'un autre | Recherche en début de mot seulement | Rechercher > Rechercher dans le mot |
| Chaque mot seul trouve des produits, ensemble ils ne trouvent rien | Tous les mots doivent être dans le même produit | Contenu des fiches, alias, tags |
| Une faute de frappe ou un synonyme ne donne rien | Recherche approximative coupée, pas d'alias | Rechercher > Recherche approximative, liste d'alias |
| Les produits sont trouvés mais pas les bons en premier | Poids des champs | Rechercher > Poids |
| Rien ne correspond à la documentation | Module tiers ou surcharge qui remplace la recherche | Modules, dossier override/ |
Cause 1 : le produit n'est pas dans l'index
Dans Paramètres de la boutique > Rechercher, le bloc Indexation compare le nombre de produits accessibles à la recherche au nombre de produits en base. Si les deux chiffres diffèrent, des produits ne peuvent pas être trouvés, quels que soient les autres réglages.
La documentation propose deux actions :
- Ajouter à l'index les produits manquants : rapide, mais n'indexe que les produits jamais indexés ;
- Reconstruire l'index : plus long, mais complet. C'est celle à lancer après de nombreuses modifications de produits déjà indexés, après un changement de taille de mot minimum ou de mots à ne pas indexer, et après une migration.
Avec l'option Indexation activée (valeur à l'installation de PrestaShop), un produit est réindexé dès qu'il est créé, modifié, dupliqué ou activé dans le back-office, ou créé et modifié par le Webservice. Un produit écrit directement en base de données, par un script d'import ou un connecteur qui passe par SQL, échappe à ce mécanisme : il reste marqué « non indexé » et n'apparaît jamais dans les résultats.
Pour une boutique alimentée par un ERP, une caisse ou un fichier fournisseur, programmez la reconstruction. Le bloc Indexation affiche une adresse à appeler par une tâche cron ; la documentation développeur en donne la forme :
0 6 * * * curl "https://votre-boutique.fr/admin-xxx/index.php?controller=AdminSearch&action=searchCron&ajax=1&full=1&token=xxxxxxxx"
Avec full=1, l'index est entièrement reconstruit ; sans ce paramètre, seuls les produits manquants sont ajoutés. Copiez l'adresse exacte, jeton compris, depuis votre back-office : celle ci-dessus n'est qu'un modèle.
Cause 2 : le produit est exclu par ses propres réglages
Le moteur filtre les produits avant même de comparer les mots. Un produit indexé reste introuvable dans trois cas :
- il est désactivé dans la boutique concernée ;
- sa visibilité (onglet Options de la fiche produit) est « Catalogue uniquement » ou « Nulle part ». Seules les valeurs « Partout » et « Recherche uniquement » le rendent trouvable ;
- la langue ou la boutique ne correspond pas : l'index est tenu par langue et par boutique. Un produit dont le nom anglais est vide ne sera pas trouvé par un visiteur anglophone sur ce mot, et en multiboutique, un produit absent d'une boutique n'est pas cherché dans cette boutique.
Ce cas se reconnaît vite : un seul produit pose problème alors que ses voisins de catégorie sont trouvés normalement.
Cause 3 : des mots trop courts ou ignorés
La taille de mot minimum fixe le nombre de caractères qu'un mot doit avoir pour être indexé et cherché. Elle vaut 3 à l'installation de PrestaShop 1.7.8, 8.2 et 9.2. Résultat : « XL », « S9 », « T2 » ou « 4K » ne trouvent rien, même s'ils figurent dans le nom du produit. Le blog technique de PrestaShop donne justement l'exemple de « S9 », qui demande une valeur de 2.
Baisser la valeur à 2 a un coût : l'index grossit, et des mots sans intérêt comme « de » ou « la » deviennent cherchables. La parade est le champ Mots à ne pas indexer, où les mots se séparent par une barre verticale (de|la|le|les|et). Vérifiez aussi l'inverse : un mot utile placé là par erreur, ou hérité d'une ancienne version, ne sera jamais trouvé.
Après toute modification de l'un de ces deux réglages, reconstruisez l'index : les produits déjà indexés gardent sinon leurs anciens mots.
Cause 4 : la recherche ne regarde que le début des mots
Par défaut, PrestaShop cherche les mots de l'index qui commencent par le mot tapé. Deux options changent ce comportement :
| Option | Effet | Exemple de la documentation |
|---|---|---|
| Rechercher dans le mot | Trouve aussi le mot tapé à l'intérieur d'un mot | « mis » trouve « chemise » |
| Rechercher la fin exacte | Le mot de l'index doit finir comme le mot tapé | « feuille » trouve « portefeuille », pas « feuilleton » |
« Rechercher dans le mot » aide pour les mots composés et les références partielles, mais élargit beaucoup les résultats sur un catalogue important. Testez-la sur vos dix recherches les plus fréquentes avant de la garder.
Les références avec tiret sont un cas à part : à l'indexation, PrestaShop découpe « A-1000 » en « a » et « 1000 », et le code récent ajoute aussi la forme collée « a1000 ». Un client qui tape la référence exacte la retrouve en général ; s'il en tape un morceau, le comportement dépend de la taille minimale et de l'option ci-dessus.
Cause 5 : plusieurs mots qui ne sont pas dans le même produit
Cette règle ne figure pas dans le guide utilisateur de PrestaShop. Pour une requête de plusieurs mots, PrestaShop cherche les produits de chaque mot, puis ne garde que ceux qui les contiennent tous. Le code le commente lui-même : chercher « red car » doit renvoyer les produits qui contiennent « red » et « car », pas l'un ou l'autre.
Exemple : « sac cuir camel » ne renvoie rien si la fiche dit « sac en cuir couleur caramel ». « Sac » et « cuir » sont trouvés, « camel » aussi sur d'autres produits, mais aucun produit ne contient les trois. Un mot qui ne figure nulle part dans l'index est écarté de la requête au lieu de la bloquer ; c'est le mot présent ailleurs qui vide les résultats.
Les corrections portent sur le contenu, pas sur un réglage :
- écrire dans le nom ou les caractéristiques les mots que vos clients utilisent vraiment (le rapport Statistiques > Recherches de la boutique les liste) ;
- ajouter des tags aux produits pour les variantes de vocabulaire ;
- créer des alias pour ramener un mot vers celui de vos fiches (voir ci-dessous).
Cause 6 : fautes de frappe, pluriels et synonymes
Le moteur natif ignore pluriels et synonymes : il compare des suites de lettres. Comme il cherche en début de mot, « chaussure » trouve « chaussures », mais « chaussures » ne trouve pas une fiche qui n'écrit que « chaussure ». Les accents, eux, sont retirés avant la comparaison : « tést » et « test » donnent le même mot.
La recherche approximative
La recherche approximative (fuzzy search) existe depuis PrestaShop 1.7.7. Quand un mot ne trouve rien, PrestaShop cherche le mot de l'index le plus proche par la distance de Levenshtein (le nombre de lettres à changer pour passer de l'un à l'autre) et relance la recherche avec lui. La documentation donne l'exemple de « colybri » qui retrouve « colibri ».
Trois points à connaître :
- elle ne se déclenche que si le mot tapé ne trouve aucun mot de l'index. « Chaussures » au pluriel n'en profite pas si un autre mot de l'index commence déjà par « chaussures » ;
- elle ne traite que 4 mots par requête par défaut (Nombre maximal de mots approximatifs par recherche) et seulement les 15 premiers caractères de chaque mot (Longueur maximale des mots), pour protéger le serveur ;
- l'écart toléré est fixé dans le code, pas dans le back-office : 8 en 1.7.8 et 8.2, 5 en 9.2.1.
L'option est cochée à l'installation de PrestaShop 1.7.8, 8.2 et 9.2. Vérifiez qu'elle l'est toujours après une migration ou une mise à jour.
Les alias et les tags
Un alias fait pointer un mot vers un autre au moment de la recherche. La documentation le présente pour les fautes de frappe (« letceur » vers « lecteur »), mais il sert aussi pour un synonyme ou un terme de métier (« basket » vers « sneaker », si vos fiches disent « sneaker »). Les alias se créent avec le bouton Ajouter un alias de la page Rechercher et s'appliquent dès l'enregistrement, sans réindexation.
Les tags agissent dans l'autre sens : ce sont des mots ajoutés au produit, donc indexés avec lui. Ils conviennent aux variantes propres à un produit ; les alias, aux règles valables pour tout le catalogue.
Cause 7 : les bons produits sont trouvés, mais mal classés
Chaque mot de l'index reçoit un poids selon le champ dont il vient. Plus le total est élevé, plus le produit remonte. Valeurs à l'installation de PrestaShop 9.2.1, identiques à celles de la documentation développeur de la version 8 :
| Champ | Poids par défaut |
|---|---|
| Références (référence, EAN13, ISBN, UPC, MPN, référence fournisseur, y compris celles des déclinaisons) | 10 |
| Nom du produit | 6 |
| Tags | 4 |
| Nom de la catégorie | 3 |
| Nom du fabricant (marque) | 3 |
| Attributs des déclinaisons | 2 |
| Caractéristiques | 2 |
| Description courte | 1 |
| Description | 1 |
Une description longue qui répète un mot peut faire remonter un accessoire devant le produit principal. Baisser son poids évite ce cas ; le mettre à 0 retire carrément les mots de la description de l'index, au prix des produits qui n'ont le mot que dans leur texte. La documentation indique que les poids s'appliquent dès l'enregistrement, mais le code les écrit dans l'index au moment de l'indexation : reconstruisez l'index pour que les produits déjà indexés en tiennent compte.
Cause 8 : un module ou une surcharge a remplacé la recherche
Si votre boutique ne réagit à aucun des réglages ci-dessus, la recherche native n'est peut-être plus celle qui répond. Trois vérifications :
- Modules > Gestionnaire de modules, recherche « search » et « recherche » : plusieurs modules de recherche actifs en même temps se marchent dessus ;
- le dossier
override/classes/du serveur : un fichierSearch.phpremplace le moteur de PrestaShop ; - le thème : un thème acheté peut fournir sa propre barre de recherche à la place de
ps_searchbar.
Lors de l'audit d'une boutique de chaussures avant sa migration vers PrestaShop 9 (cas décrit dans notre article sur la lenteur), nous avons trouvé trois systèmes de recherche superposés, 79 fichiers de surcharge liés à un seul module de recherche tiers et plus d'un million de lignes dans l'index. La migration repart sur un seul moteur.
Pour tester sans risque, désactivez le module suspect sur une copie de la boutique, videz le cache dans Paramètres avancés > Performances, puis relancez vos recherches de référence.
La recherche à facettes n'est pas la recherche
Le module Recherche à facettes (ps_facetedsearch) affiche les filtres d'une liste de produits : prix, taille, couleur, marque. Il filtre une catégorie, et la page de résultats de recherche si un modèle de filtres l'y active. Il ne décide pas quels produits la recherche trouve.
Une recherche qui ne trouve rien se règle donc dans Paramètres de la boutique > Rechercher, et des filtres qui ne s'affichent pas se règlent dans la configuration du module Recherche à facettes (modèles de filtres, catégories cochées, index des filtres à reconstruire depuis le module). Ce sont deux pannes distinctes, souvent confondues parce que les deux portent le mot « recherche ».
Quand passer à un module de recherche ?
Une fois les réglages et les fiches corrigés, le moteur natif suffit à beaucoup de boutiques. Un module devient utile quand vous avez besoin de ce que le natif ne sait pas faire :
- tolérer plusieurs fautes dans une même requête et gérer les pluriels sans alias ;
- gérer des centaines de synonymes ou un vocabulaire technique dans plusieurs langues ;
- mettre en avant des produits sur certaines recherches et suivre les recherches sans résultat ;
- garder des réponses rapides sur un gros catalogue avec beaucoup de déclinaisons.
| Famille | Exemples | À vérifier avant d'acheter |
|---|---|---|
| Service hébergé par l'éditeur | Doofinder (module officiel sur PrestaShop Addons), Algolia (modules de tiers) | Abonnement selon le volume, données produits envoyées chez l'éditeur, contrat de sous-traitance |
| Moteur installé sur votre serveur | Modules basés sur Elasticsearch ou OpenSearch | Serveur assez puissant, maintenance du moteur, compatibilité avec votre version |
| Module amélioré dans la boutique | Modules « recherche avancée » de PrestaShop Addons | Surcharges installées, compatibilité PrestaShop 9, mises à jour suivies |
Nous ne citons pas de prix : ils changent selon le volume de produits et de recherches, et chaque éditeur publie sa grille. Avant d'en installer un, faites le diagnostic ci-dessus : branché sur des fiches qui n'emploient pas les mots de vos clients, un module laissera les mêmes trous. Et gardez un seul moteur actif.
Faire vérifier votre recherche
Pour faire régler la recherche native de votre boutique, nous proposons une intervention à prix fixe : recherche PrestaShop qui ne trouve rien, diagnostic et réglages. Elle couvre les 8 causes de ce guide, la reconstruction de l'index, les réglages, les alias et les poids. L'installation d'un module de recherche tiers n'y est pas comprise.
Si les produits sont dans l'index, les réglages cohérents et la recherche toujours vide, il reste à lire le code qui répond réellement : module, surcharge ou thème. Notre dépannage PrestaShop est à 165 € TTC, prix fixe : recherche de la cause, correction et contrôle sur vos recherches habituelles ; si nous ne réparons pas, vous ne payez rien. Le suivi régulier des réglages, de l'index et des mises à jour de modules fait partie de la maintenance PrestaShop, dès 165 € TTC par mois, sans engagement.
Pour un besoin que le natif et les modules du marché ne couvrent pas (recherche par compatibilité de pièces, par référence fournisseur, par mesure), nous développons des modules PrestaShop sur mesure, sur devis écrit. Et si votre boutique tourne encore en 1.6, sans recherche approximative, la migration vers PrestaShop 9 règle aussi ce point.
Sources
Consultées le 21 novembre 2026.
- PrestaShop, guide utilisateur 1.7 : Préférences de recherche
- PrestaShop, guide utilisateur 8 : Search parameters
- PrestaShop, documentation développeur 8 : Search index
- PrestaShop, blog technique : Introduction to the fuzzy search (1.7.7)
- PrestaShop 9.2.1, code du moteur de recherche (classes/Search.php) et valeurs par défaut à l'installation
- Module Barre de recherche (ps_searchbar) et module Recherche à facettes (ps_facetedsearch)
- Doofinder, guide d'installation du module PrestaShop
