Skip to content

Sidekick and Flow ​

Marutto Search's data is available to Sidekick, Shopify's AI assistant, and to Shopify Flow, Shopify's automation.

What you can doPlan
Ask Sidekick how search is doingEvery plan (what each plan sees is below)
Ask Sidekick why a product is missing from searchEvery plan
Have Sidekick find reviews and draft repliesBasic and up
Receive search data in Flow (weekly report, searches with no results, ...)Pro ("Search sync issue" is on every plan)
Change search from Flow (priority, hiding, synonyms, redirects)Pro
Start from a Flow template (six of them)Pro (the review alert is on Basic and up)

Sidekick ​

Ask Sidekick in the Shopify admin, in your own words. It answers whether or not Marutto Search is open.

Ask something likeIt answers fromPlan
"How did search do last week?"Searches, the no-results rate, the click rate, the most searched termsEvery plan
"How much does search sell?"Orders and revenue from search, against the period beforePro
"Which searches found nothing?"Search terms with no results, and how oftenPro
"What do people who search for 'gift' buy?"That term day by day, the products clicked and bought after itPro
"Which searches find this product?"The terms that led to clicks and orders of the productPro
"What should I fix in search?"The improvement suggestions (synonyms, redirects, product priority, ...)Pro
"Why doesn't this product come up in search?"The index, its status, excluded tags, rules that hide it, out-of-stock handlingEvery plan
"Which reviews are waiting?" "What's rated poorly?"Review counts, the average, low-rated products, what reviews sayBasic and up
"Show me my synonyms"Synonyms, redirects, product priority and keyword display rulesPro
  • The report period is the admin report's: Free covers the last 7 days, Basic the last 30, and Pro chooses 7, 30 or 90
  • Sidekick reads only the search and review data Marutto Search holds. The names of customers who wrote reviews are never passed to it
  • The improvement suggestions can take some tens of seconds to work out the first time. If Sidekick says they are being prepared, ask again shortly

Acting from Sidekick ​

Sidekick does not change Marutto Search's settings on its own. A change is made on the Marutto Search page Sidekick opens, after you check it and save.

  • Reply to a review, publish it, or hide it: ask "reply to this review" and the review's page opens with a draft in the reply field. Nothing is shown on your store until you save
  • Add a synonym, a redirect or a product priority, or hide a product from search: ask "add 熨斗 as a synonym for のし" and Sidekick checks that it can be added, then gives you a link to the page with the values filled in. Save there. To add to a word that already has synonyms, use Edit beside that word in the list the link opens

The "Ask Sidekick" button ​

On stores where Sidekick is available, Marutto Search's Search improvements pages (the report, the search terms table, the suggestions) show an Ask Sidekick button. It opens Sidekick with a question about that page.

If Sidekick does not appear

Sidekick is a Shopify feature and is not available on every store. Where it is not, the button is not shown.

Shopify Flow ​

In Flow, Marutto Search is listed as Maru Search & Filter, its name on the Shopify App Store. Look for that name when filtering templates and when picking a trigger or an action.

Templates ​

The workflows merchants set up most often are in Flow's template library, ready to install. There is no need to build them step by step.

TemplateStartsWhat it doesPlan
Send an internal email when a search term keeps finding no resultsThe Search with no results trigger: a term found nothing 3 or more times in 7 days (once a week for a term, up to 20 terms a day)Emails the term and the countPro
Send an internal email when a search term is trendingThe Trending search term trigger: a term was searched 5 or more times in the last 7 days and at least twice as often as in the 7 days before (once a week for a term, up to 10 terms a day)Emails the term and the searches of both periodsPro
Send an internal email when the weekly search report is readyThe Weekly search report trigger. Every Monday morning (Japan time)Emails the searches, no-result rate, click rate, orders and revenue from search, and most searched term of the week before (Monday to Sunday)Pro
Prioritize a product in search for 14 days when it is added to the storeShopify's Product created trigger: a product is added to the storePrioritizes the product (priority 2) and removes the priority 14 days laterPro
Add an order tag when an order comes from site searchThe Order from search trigger: an order that came from search is confirmedAdds the tag 検索経由 ("from search") to the order, so the order list can be filtered by itPro
Send an internal email when a low-rated review is submittedThe Review submitted trigger: a review is submitted and waits for approvalFor a review of 2 stars or lower, emails the rating and the review IDBasic and up

To install one:

  1. Open Flow in the Shopify admin and click Browse templates
  2. Filter the templates by app and pick Maru Search & Filter
  3. Pick a template and click Install. The workflow is added turned off
  4. For a template that sends an email, open the Send internal email step and enter the recipient (To)
  5. Click Turn on workflow
  • The subject, the message, the days to wait, the tag and the priority can all be changed after installing
  • What the search triggers hand to a workflow (the variables an email can use) is listed under Triggers
  • Prioritize a product in search for 14 days also removes a priority you set on that product yourself in the meantime. Turning the workflow off leaves the priority on the products still waiting; remove it under Product priority in Marutto Search (Boosts and pins)
  • Up to 200 products can be prioritized at once, counting the ones you set yourself. A product added beyond that is not prioritized

Triggers: receiving search data ​

Pick Marutto Search under Select a trigger in a workflow.

TriggerStartsPlan
Weekly search reportOnce each Monday from 9:00 Japan time, with the week before (Monday to Sunday)Pro
Search with no resultsDaily from 9:00, for each term that found nothing 3 or more times in the last 7 days (a term once a week)Pro
Trending search termDaily from 9:00, for each term searched 5 or more times in the last 7 days and at least twice the 7 beforePro
Order from searchWhen an order that came from search is confirmed. Once an orderPro
Search sync issueWhen syncing the search index fails, or a product-count drift is rebuiltEvery plan

A day's starts are capped: 20 terms a store for searches with no results and 10 for trending terms, the most searched first.

Weekly search report variables ​

Flow variableMeaning
periodStartFirst day of the period (a Monday, YYYY-MM-DD)
periodEndLast day of the period (a Sunday, YYYY-MM-DD)
searchesSearches
zeroResultSearchesSearches with no results
zeroResultRateShare of searches with no results, in percent
clickRateShare of searches with a click, in percent
ordersOrders from search
revenueRevenue from search
currencyCurrency of the revenue
topQueryMost searched term
topZeroResultQueryMost searched term with no results (- when none)
eventIdAn ID to dedupe by

A week with no searches starts nothing.

Search with no results and trending search term variables ​

TriggerFlow variables
Search with no resultsquery (the term), zeroResultSearches (times it found nothing in the last 7 days), searches (searches in the last 7 days), lastSearchedAt (UTC), eventId
Trending search termquery, searches (last 7 days), previousSearches (the 7 days before), growthRate (how many times as many; 2 is double), eventId

To act only on busier terms, compare zeroResultSearches or searches in a Flow condition (for example, notify only at 10 or more).

Order from search variables ​

Flow variableMeaning
orderThe order (a reference)
queryThe search term that led to the order (the larger amount, if several)
revenueAmount of the products bought through search
currencyCurrency of the amount
productCountNumber of products bought through search
eventIdAn ID to dedupe by

"From search" means a shopper opened a product from the search results and bought it within 24 hours. The trigger starts once the order is confirmed, on stores where purchase measurement is on.

Search sync issue variables ​

Flow variableMeaning
kindfull_sync_failed (a full sync failed), index_rebuilt (a drift was rebuilt), index_rebuild_failed (the rebuild failed)
reasoncapacity, shopify_api (Shopify's response), count_mismatch (the product counts differed), error (anything else)
occurredAtWhen it happened (UTC)
eventIdAn ID to dedupe by

A store is told about a failure once a day at most.

Deduping

Flow can deliver a trigger twice for one event. Where a second notification or tag would matter, dedupe by eventId.

Actions: changing search ​

Pick Marutto Search under Add an action in a workflow. All of them are Pro's.

ActionInputWhat it does
Add synonymWord, synonyms (comma-separated, up to 20)Adds synonyms for the word, or adds to the ones it has
Add redirectSearch term, destinationRedirects the term to a page in the store, updating the redirect it already has
Prioritize productProduct, priority (0.1 to 10)Ranks the product higher in search. 1 is neutral; higher ranks higher
Remove product priorityProductRemoves the product's priority
Hide product from searchProductHides it from every search. Its page and status stay as they are
Show product in searchProductPuts a product hidden with Hide product from search back
  • A destination is a path in the store, starting with / (for example /collections/sale). Add a redirect to an address outside the store in the admin
  • Hide product from search adds one rule to the admin's keyword display rules: hidden, for every search term. It counts towards their limit of 300
  • A product that is pinned, or given a score multiplier, for every search term cannot be hidden by this action: the step fails and the run history says why. An automation does not overwrite a rule you made by hand. Remove that rule in the display rules first
  • Synonym, redirect and priority changes appear in the change history under Settings → Search rules as From Shopify Flow
  • An action that runs twice leaves what running it once did

Examples ​

Prioritizing a new product, hearing about a term that finds nothing or is on the rise, and tagging orders from search are all templates. Once installed, a template can be adjusted:

  • Hear only about the terms that fail most: in Send an internal email when a search term keeps finding no results, add a condition "zeroResultSearches is at least 10" between the trigger and the email
  • Change how long a product is prioritized: in Prioritize a product in search for 14 days when it is added to the store, change the days in the Wait step
  • Change the tag: in Add an order tag when an order comes from site search, change the tag in the Add order tags step

Keeping sold-out products out of search needs no workflow: under Settings → Search, set Out-of-stock products to Hide, on every plan (Out-of-stock handling).

Marutto Search