- Home
- Documentation
- Search
- How search finds products
How search finds products
How Toldo searches: SKUs and barcodes first, accents and typos forgiven, plurals understood, and the words shoppers use in each country.
This feature is rolling out: we're turning it on in stages with our founding partners. What this guide describes may change before general availability.
In short
Toldo's search puts first the products you pinned for that search and those whose SKU or barcode matches the code typed, such as a part number. Then it searches the words regardless of accents or capitals, forgiving typos and understanding plurals, and maps other countries' words to the ones your store uses: on a Mexican store, “remera” also finds “playera”. You can also add synonyms of your own.
The order of the results
Each search builds its list in this order:
- Pinned products. The ones you pinned for that search with a rule, in your order. See Search rules.
- Codes. If what's typed looks like a code, up to 10 products with a SKU or barcode that is that code or starts with it.
- Words. The rest of the products that match the words: first the ones you boosted with a rule, then by relevance. Among results of similar relevance, the ones in stock come first and, when the search has no boosted products, the best-sellers of the last 30 days.
A rule can also hide products or send the search to a page. If the words find nothing, Toldo tries once more with the regional vocabulary's fallback words (below).
SKUs, barcodes and part numbers
- No separators. Toldo compares codes regardless of capitals, spaces, hyphens or slashes: “ABC-123/45”, “abc 123 45” and “abc12345” are the same code.
- No typos. It forgives no typos in codes: a different digit is another product.
- From every variant. It uses the SKU and the barcode of every variant of the product (on products with more than 50 variants, possibly only the first ones).
A search counts as a code when it has at least one digit, 3 to 40 characters and no more than three parts (separated by a space, hyphen, dot, slash or underscore), and no part is a word of 4 or more letters: for example, “ABC-123”, “7501031311309” or “bp 4520”. That's why “camisa 2” is searched as words.
A part number is searched as a code when it's in a variant's SKU or barcode; if it's only in the title or the description, it's searched as words.
Accents, typos and plurals
- Accents and capitals. They don't matter: “pantalon” finds “Pantalón” and “nino” finds “Niño”.
- Typos. Toldo forgives them in words.
- As shoppers type. The last word counts as the start of a word: “cami” already finds “camisa”.
- Plurals. “camisas” finds “camisa”, irregular plurals too, such as “lápices” and “lápiz”, or “children” and “child”.
- Where it looks. In the title, which weighs most; in SKUs and barcodes; in the vendor, the type, the tags, the option values and the variant titles; and last in the description.
Your store's language
Search reads your products in the language you choose under Settings, in Language of your product texts: Spanish, Portuguese or English. Toldo picks it from your store's country: Portuguese in Brazil and Portugal, Spanish in Spain and the Spanish-speaking countries of the Americas, and English everywhere else. If you change it, Toldo rebuilds the search index.
Toldo searches your product texts in your store's primary language: it doesn't search their translations.
Regional vocabulary
Shoppers in other countries use other words for the same things: Mexico's playera (T-shirt) is a remera in Argentina and a polera in Chile. Under Regional vocabulary you choose which country's words your store uses, and Toldo maps the other countries' words to them:
- One way. On a Mexican store, “remera” also finds “playera”, but “playera” doesn't find “remera”.
- English words. “hoodie” also finds “sudadera”.
- Your country's alternatives are equivalent. In Mexico, “jeans” and “pantalón de mezclilla” find each other.
- Words that mean something else in your country are used only when there are no results. In Mexico, zapatillas are heels: searching “zapatillas” shows your heels, not sneakers (tenis). Only if it finds nothing does Toldo try “tenis”, and the results page says “Showing results for related words” (in the language the shopper is browsing your store in, if it's Spanish, Brazilian Portuguese or English; otherwise in English).
There's vocabulary for Mexico, Argentina, Colombia, Chile, Peru, Spain and Brazil: 34 items whose name changes by country (clothing, footwear, accessories, home, tech, baby, car and stationery), plus a few same-language equivalents, such as “pegamento” and “adhesivo”. The Spanish-speaking countries' words map among themselves; on a Brazilian store, Toldo maps English words and Brazil's own alternatives.
Toldo picks your store's country if it's on the list; if not, the vocabulary is set to None.
Synonyms of your own
Under Synonyms you add the words shoppers use for what you sell. They always apply, with or without the regional vocabulary. There are two types:
- One way: a word also finds others. Type the word in When shoppers search and the words it should find in Also find.
- Equivalent: each word finds the others. Type them all in Words.
Separate words with commas: 20 at most, each up to 60 characters. There's no need to type both the singular and the plural: Toldo recognizes both.
Steps to add a synonym
- Open Synonyms. In Toldo, go to Search and open Synonyms.
- Choose the type. Click Add synonyms and choose the Type.
- Type the words. Fill in When shoppers search and Also find, or Words if they're equivalent, separated by commas.
- Save. Click Save: “Synonyms saved. They apply to new searches in a few seconds.”
Under Analytics, Add synonym opens this form with the search already filled in. See Search analytics.
Frequently asked questions
Does it find a SKU typed with or without hyphens?
Yes. Toldo compares codes without spaces, hyphens or slashes, so “ABC-123/45” and “abc12345” find the same product.
Does it search my product translations?
No. It searches your product texts in your store's primary language.
Can I turn off the regional vocabulary?
Yes. Under Settings, choose None in Regional vocabulary, or uncheck Use the regional vocabulary, and click Save. Your own synonyms keep working.
Why doesn't a product show in the results?
Only products that are active and published to your online store show up. It may also be hidden by a search rule. If you've just changed it in Shopify, wait a few seconds. If you've just published it to the online store and it doesn't show, click Import again under Overview.