You ask Sidekick about a product. You can see it in your product list. And Sidekick answers that it couldn't find anything matching.
It's a small thing that makes you doubt the whole tool. In most cases the product is fine and Sidekick is fine, and the gap is in how the question lined up with the data. Here are seven likely reasons, most common first, and the phrasing that gets past each.
One note before the list. Shopify doesn't publish a troubleshooting guide for this, so what follows is practical reasoning about how an assistant matches a question to store data, not a list of documented Sidekick behaviours. Try them in order.
1. The name you used isn't the product's name
You call it "the grey hoodie." In your admin it's "Fleece Pullover, Heather." Nothing in the title says grey or hoodie.
You know they're the same thing. Sidekick is matching words to product data, and it may not make the leap.
Try: the exact title. Or describe it and ask for candidates: "List products with 'fleece' or 'pullover' in the title."
This is worth more than a workaround. If the words your team naturally uses for a product don't appear anywhere in its data, your customers' words probably don't either.
2. It's a variant, not a product
"Find the Atlas backpack in olive" asks for a variant: one colour of a product. If you ask for it as though it were a product, the search may come up empty.
Try: ask at the product level, then narrow. "Show me the Atlas backpack and its variants."
3. It's a draft or archived
Your admin holds products in three statuses: active, draft, and archived. Sidekick works from that admin data. But a question framed around selling, like "which products do I sell in the outdoor category," implies active products, and a draft may be left out of the answer.
Try: say the status. "Include draft and archived products."
Also check the product itself. If it was archived by mistake, that explains more than a Sidekick answer.
4. A typo or a near-match
"Harlowe tote" against a product called "Harlow Tote." People read past that. A search may not.
Try: the SKU or the handle. A SKU like HRL-TOTE-BLK or the handle from the product's URL has no near misses.
5. The detail you asked about lives in an app
"Which products have the best reviews?" "Which products are in my subscription program?" "Which bundles include the Atlas?"
Sidekick knows Shopify's own data. By default it doesn't see inside the apps you've installed. If a reviews app holds your ratings or a bundle app defines your bundles, that information is in the app's records, and Sidekick can't search it unless the app provides a Sidekick app extension.
So Sidekick isn't failing to find the product. It's failing to find the attribute you used to describe it.
Try: ask about the product by a field Shopify owns: title, type, vendor, tag, collection, price. We map the boundary in what data Sidekick can see.
6. The detail is buried or missing
"Find my waterproof jackets." If "waterproof" appears in a tag or a product attribute, that's an easy match. If it appears once in the fourth paragraph of a description, it's a harder one. If it's only in a product photo, it isn't in the data at all.
Try: search by something structured. "Products in the Jackets collection." Then fix the root cause by putting the attribute where it can be found: a tag, the product type, or a category attribute.
7. The question was too broad or too layered
"Find the jacket that sold best last spring among the ones we restocked in March and tell me its margin" is four lookups in one sentence. If any step comes up short, the whole thing can return nothing.
Try: one step at a time. Find the product first. Then ask about it.
Two quick checks if none of those is it
Your permissions. If you're on a staff account with limited access, there may be parts of the store you can't see in the admin, and you shouldn't expect an assistant acting for you to see them either. Open the product directly. If you can't, that's your answer.
The right store. If you manage several stores, make sure you're in the one that has the product.
How to ask so Sidekick finds it
A short ladder, from most to least dependable:
- Ask from the product's page. Open the product in the admin, then ask. The context is unambiguous.
- Use the SKU. "Show me the product with SKU HRL-TOTE-BLK."
- Use the exact title, copied from the admin.
- Use a structured field. Collection, tag, vendor, or type.
- Describe it loosely, as a last resort, and ask for a list of candidates to choose from.
More patterns in Sidekick prompts that save time.
When it's pointing at a real problem
Sometimes "I can't find that" is the most useful thing an assistant tells you all week.
If Sidekick can't connect "grey hoodie" to your grey hoodie, with full access to your admin, ask who else can't. Your storefront search works from the same titles, tags, and types. So do the AI shopping assistants your customers use, and they see far less than Sidekick does. They only get what your storefront publishes.
A product that's hard to find from the inside is usually harder to find from the outside. The fixes are the same in both directions:
- Put the words people use in the title. "Fleece Pullover Hoodie, Heather Grey" finds itself.
- Fill in the product type and category. That's how a product gets matched to "hoodie" at all.
- Use tags and attributes for the things people filter by: waterproof, vegan, wide fit.
- Keep facts in fields, not only in prose.
We cover the shopper-facing version of this in why can't AI tools find your Shopify store? and how the two connect in your AI assistant and your shoppers' AI read the same catalog. For fixing the data itself, see filling missing product data with AI.
To see what an outside AI assistant can read from your store, run the free AI readiness checker. It takes about a minute.
Quick reference
| What you asked | Likely issue | Ask this way |
|---|---|---|
| A nickname | Name doesn't match the title | Exact title, or list by keyword |
| A colour or size | That's a variant | Ask for the product, then its variants |
| A product you're not selling yet | Draft or archived | "Include draft and archived" |
| A slightly misspelled name | Near-match | SKU or handle |
| "Best reviewed," "in a bundle" | Data lives in an app | A Shopify field: tag, type, collection |
| A feature, like "waterproof" | Not in a structured field | Collection or tag, then fix the data |
| Several conditions at once | Too layered | One step at a time |


Comments
Every comment here comes from a verified email. Write yours, confirm from your inbox, and it's live.
Loading comments…