Skip to main content

Catalog indexing has been failing, what that means and what to do

What it means when your Business Brief says Arbyn's catalog indexing has been failing, why it happens, what still works while it's stuck, and when to reach out.

Written by Joseph

Every few hours, Arbyn runs a routine pass over your published products to keep its search up to date with your live Shopify catalog. Almost all the time this is invisible, it just happens. If that pass keeps failing for the same store, though, your Business Brief will start saying so directly instead of quietly promising it'll finish soon. This article explains what that message means, why it happens, and what to do about it.

What it does

Arbyn reads your published products on a regular schedule and turns them into a searchable index, the thing that lets it match a shopper's question ("something for the bedroom," "do you have this in blue") against your real catalog. Most stores never think about this because it works automatically in the background. But if that indexing pass fails repeatedly, in a row, for your store specifically, Arbyn now tells you honestly on your Business Brief instead of continuing to say "still indexing, that finishes automatically" indefinitely.

Where to find it

Knowledge → Business Brief, in the "What Arbyn knows" section, under what Arbyn says about your catalog. You'll see a sentence naming how many of your published products are indexed, and if indexing has stalled, a line that says indexing the rest has been failing and to contact support if it doesn't clear up on its own.

How it works

A normal pass, and a stalled one, look different from the inside. Arbyn's indexing runs roughly every three hours. Most failures at that cadence are transient, a brief hiccup somewhere in the pipeline, and the very next run clears it without you ever seeing a thing. Arbyn only starts telling you about it once the same store has failed three runs in a row, roughly nine hours of sustained failure rather than a single blip. That's a deliberate line: short enough that you're not kept in the dark for days, long enough that a one-off hiccup never shows up as an alarming message on your Business Brief.

What "indexing" actually covers. This is specifically about turning your published products into something Arbyn's search can match against, separate from the catalog audit on Knowledge → Catalog, which checks whether individual products have the details (description, images, tags) Arbyn uses to describe them well. A product can be indexed and still be missing details worth filling in, and a product can have a perfect listing and simply not be indexed yet if this process has stalled.

What still works while it's stuck. Products Arbyn had already indexed before the failures started keep working exactly as before, this only affects the products still waiting to be picked up. If you've recently published a large batch of new products, or your whole catalog is new, more of your store can be affected than if it's just the newest handful of items.

Why it happens. Almost always this traces back to a temporary problem with the AI service that powers indexing, an outage or degraded period on the provider's end, not something you did in Shopify. Less commonly, it can be caused by a genuinely malformed product record. Either way, this isn't something you can fix from inside Shopify or from your Arbyn settings, there's no manual "retry indexing" button, because there's nothing wrong with your setup to change.

Self-healing, honestly reported. The moment a single indexing run succeeds for your store, the failure count resets straight back to zero and the honest message disappears from your Business Brief on its next refresh. You don't need to do anything to clear it; if the underlying issue resolves, your Brief simply goes back to reporting normal indexing progress.

When to actually reach out. If the message has been showing for a while, more than roughly a day, and hasn't cleared on its own, that's the point to contact support rather than keep waiting. At that point it's likely something on our end needs a closer look for your store specifically, rather than the transient kind of failure that clears itself within the normal three-hour cadence.

Good to know

  • This message only appears once it's genuinely stuck, not on the first missed run. A single slow or failed pass never shows up here; it has to fail three runs in a row before your Business Brief says anything about it.

  • It's honest in both directions. The same Business Brief that tells you when indexing is stalled also goes right back to "finishes automatically" language the moment a run succeeds, nothing lingers after the underlying problem clears.

  • Already-indexed products are unaffected. A stall only holds up products still waiting to be indexed for the first time; anything Arbyn indexed before the failures began keeps answering normally.

  • There's nothing to configure or retry yourself. This isn't a setting, and there's no manual "try again" action, if it's stuck, reaching out is the right move rather than looking for a button.

FAQ

Does this mean Arbyn stopped working entirely? No. Arbyn keeps answering customers using everything it indexed before the failures started, and using its general knowledge of your store. It's specifically the products still waiting to be picked up for the first time that are affected.

How long does indexing normally take for a new or recently expanded catalog? Under normal conditions, it finishes automatically within a few hours. The stalled message only appears once that normal process has actually failed for roughly nine hours straight, not simply because a large catalog takes a little while.

Is this the same thing as the catalog audit on Knowledge → Catalog? No, they check different things. The catalog audit flags products missing details Arbyn uses to describe them (a description, an image, tags). This is about whether your products have been turned into something Arbyn's search can find at all, separate from how complete any one listing is.

What should I do if I see this message? Nothing right away, it often clears on its own within the normal cadence. If it's still showing after about a day, contact support so we can look into what's happening for your store specifically.

Did I do something wrong in Shopify to cause this? No. This isn't caused by anything in how you've set up your products or store, it's almost always a temporary issue on the service that powers indexing, not a configuration problem you need to fix.

Did this answer your question?