Troubleshooting

The preview shows entries but the storefront shows nothing

• Check you added .value to the metafield path. shop.metafields.lists.handle is the metafield object; .value is the array.
• Check the handle. The key is the list's handle, shown in the editor, not its name.
• Check the context. A per-product list is on product.metafields, not shop.metafields, and only on products that at least one matching entry references.
• Storefront pages are cached. Wait a minute and reload.

A bound block in the theme editor is empty

• The template JSON must read "{{ product.metafields.lists.handle.value }}", with .value.
• Store-wide lists cannot be dynamic sources. Shopify does not allow shop metafields there. Read them in Liquid instead.
• The block's setting must be of type metaobject_list, and it shows at most 50 entries.

Only 50 entries render

Liquid exposes only the first 50 entries of a list metafield, whatever you do with offset, reversed or index access. Make further lists with an offset in the app, one metafield each. See the Liquid reference.

The page says "Something went wrong"

Shopify gives every storefront page a rendering budget, and a page that draws too many cards from long lists can run out of it, sometimes only on some requests. The cost is in what each card renders: a card that reaches into a product and a referenced author is several lookups. On Four Mile Books a page drawing 179 such cards from five lists failed on about half its requests; the same page capped at 90 cards renders every time.

Cap what a page draws. Either give the list a limit in the app so the metafield holds only what the page shows, or stop the loop early in Liquid with forloop.index. Keep long A to Z lists on a page of their own, and keep the per-card Liquid light.

The list is out of date

Changes normally arrive within fifteen seconds. If a list is stale:

1. Open the app. If it has not received webhooks for a while, it checks them on open and re-registers any that are missing.
2. Choose Re-sync entries on the home page. This re-reads every entry of every type and rewrites every list whose result changed.
3. If a specific type never updates, open a list on that type and save it again. Saving re-registers the type's webhooks.

The nightly sweep catches anything missed.

A list is marked "needs attention"

A field used by the list no longer exists on the type, or a referenced entry used in a condition was deleted. Open the list; the banner names the problem. Fix the condition and save. Until then the last written result stays in place.

Import skipped a list

The message names the missing type or field on the target store. Create it under Settings › Metafields and metaobjects with the same handle and key, then import again with Overwrite ticked.

The preview and the saved result differ

The preview evaluates against the copy at that moment; the saved result is what was written at save time. If entries changed in between, save again. If the preview includes drafts and the saved list does not, check Include drafts.

I uninstalled and the lists are still on my products

That is intended. The metafields and their definitions stay so nothing breaks in the theme. Remove the definitions under Settings › Metafields and metaobjects › Products and Collections if you want them gone.

Something else

Email [email protected] with the store domain, the list handle, and what you expected to see.