All guides

Search

Turn on Toldo search

How to turn on Toldo search and add it to your theme with instant search and the results block, and what happens if Toldo doesn't answer.

Rolling outUpdated

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

You turn on search in Toldo, under Search, with Turn on search: Toldo copies your catalog and builds a search index in the background. Then, in the theme editor, you turn on instant search and add the results block to the search page. Your store doesn't change until then, and if Toldo doesn't answer in time, your theme's own search shows.

What it adds to your store

  • Instant search. As shoppers type in your theme's search box, once they've typed two characters, products appear with their image and price, along with popular searches and a link to all the results.
  • Results page. On your theme's search page, Toldo's results with filters (brand, type, options such as size or color, availability and price), sorting and pages.

Both work with the search box and search page your theme already has. Your collection pages don't change, except their order if you set it up: see Sort collections automatically.

Toldo shows Search to every Shopify store, turned off until you turn it on.

  1. Turn on search. In Toldo, open Search and click Turn on search. Toldo copies your catalog (products, collections and recent sales) and builds a search index in the background. On large stores it can take a few minutes.
  2. Check the settings. Under Settings, check Language of your product texts and Regional vocabulary: Toldo picks them from your store's country. If you change anything, click Save. See How search finds products.
  3. Turn on instant search. Under Overview, in Turn on instant search, click Open the theme editor. The editor opens with Toldo's instant search ready to turn on (in the editor, the block is called “Instant search”): check that it's on and save your theme changes.
  4. Add the results block. In Show Toldo's results on the search page, click Add the block. The editor opens on your theme's search template with Toldo's “Search results” block in a new section. Save your theme changes.
  5. Try a search. Once the index is ready, search for a product in your store (not in the theme editor's preview) and open the results page. Under Overview you'll see “Search is live in your store”, with the searches of the last 7 days.

When it starts working

Instant search and the results block show nothing until search is on and the first index is ready: until then, your store keeps your theme's own search. Under Overview you see how it's going (“Importing your catalogue…”, “Building the search index.”), and Activity shows “Search index built” when it's done.

If Shopify doesn't let Toldo use its bulk import, Toldo imports the catalog page by page and the Overview says so. On large stores it takes longer.

After that, Toldo keeps the index up to date on its own:

  • changes to your products arrive a few seconds later;
  • every hour it catches up on changes Shopify didn't send;
  • once a week it imports your products and collections again (sales come in with each paid order and the hourly catch-up);
  • once a day it rebuilds the index, because sales and stock change the order of the results even when you edit nothing.

To import the whole catalog right away, click Import again under Overview.

Only products that are active and published to your online store go into the index: drafts and archived products leave the results a few seconds after the change. If you only unpublish a product from the online store, it may keep showing until the next weekly import; to remove it sooner, click Import again under Overview.

If Toldo doesn't answer

Toldo never leaves your store without search:

  • Instant search. Your theme's search box always keeps working. Your theme's own suggestions are hidden only after Toldo's first answer on that page, and only on Dawn, Dawn-based themes and Horizon: on other themes they may show next to Toldo's. If Toldo doesn't answer within a second and a half, or answers with an error, it shows no suggestions; if it had already answered on that page, your theme's suggestions come back after three failures in a row.
  • Results page. While Toldo's results load, your theme's results are hidden. If they take more than two and a half seconds or fail, your theme's results show.
  • Search engine unavailable. The Overview tells you: “The search engine can't be reached right now. Your theme's own search is showing until it can.”

Settings in the theme editor

BlockSettingWhat it does
Instant searchProducts to show1 to 6 products in the suggestions (6 by default)
Instant searchShow popular searchesOn by default. See Search analytics
Instant searchSearch boxes (CSS selector)Your theme's search boxes that Toldo uses. The default works with Dawn and most themes
Search resultsProducts per page4 to 48 (24 by default)
Search resultsShow a headingOff by default; turn it on if your theme shows no heading on the search page
Search resultsHide the theme's results when Toldo's loadOn by default
Search resultsTheme's results (CSS selector)The parts of the page that are hidden; change it only if you see your theme's results next to Toldo's

If a shopper buys in another currency (Shopify Markets), search shows that market's prices from Shopify, not the index's; if Shopify doesn't give them, it shows no price. In another currency, the results page doesn't offer the price filter either.

Under Settings, in Turn off search, click Turn off search: “Your theme's own search comes back at once. Your rules, synonyms and analytics are kept.” To turn it on again, click Turn on search under Overview.

While it's off, Toldo doesn't sort your collections either: they keep the last order it wrote. To give a collection back the order it had before Toldo, choose Leave it to Shopify on it.

Limits per plan

Every search feature is in every plan. Plans only change how many products of your catalog search covers:

PlanProducts
Free1,000
Start10,000
Growth50,000
Pro250,000

If your catalog goes over your plan's limit, nothing switches off: search and collection sorting keep working. The Overview asks you to choose a bigger plan when all the products Toldo copied from your store, drafts and archived ones too, go over the limit, and Activity tells you once a day when the products in the index do. The Plan page shows each plan's limit. See Plans and limits.

Frequently asked questions

No. Toldo copies your catalog and builds the index in the background, but your store stays the same until you turn on instant search and add the results block in the theme editor.

What happens if Toldo search stops answering?

Your store shows your theme's own search: its suggestions if Toldo doesn't answer within a second and a half (on a page where it had already answered, after three failed tries in a row), and its results if Toldo's take more than two and a half seconds or fail.

Can I use instant search alone?

Yes, instant search and the results block are independent. But searches are counted on the results page and redirects happen there: without the “Search results” block, your analytics only count clicks, rules that send shoppers to a page don't apply, and instant search suggests no popular searches, since they come from the searches counted.

Do my draft products show up?

No. Only products that are active and published to your online store go into the index.

Does search cost extra?

No. It's included in every Toldo plan; plans only change how many products it covers.