Skip to main content
Shopify already knows which product a page is about, what is in the basket, who is signed in and what was bought. The app reads all of it, so there is no tagging to write and nothing to keep correct as your theme changes.
This replaces the manual steps entirely. If you install the app you do not need page context, category and search or conversions — the extensions send all of them.

​
Install

1

Add the app

Install NeuronSearchLab from the Shopify app store.
2

Create an embed key

In the console, Developers → Website embed. Add every storefront domain to the key’s origins, including any you preview from.
3

Turn on the app embed

Theme editor → App embeds → NeuronSearchLab. Paste the key and save. That is the whole installation — the widget now loads on every page and reports context.
4

Place a strip

Drag Recommendations into any template. Give it a placement name if you want to configure it from the console later.

​
What the app sends

None of this is hand-written; it all comes from Shopify.

​
Conversions

Orders are reported by a web pixel, because Shopify’s checkout is not your theme and no theme code runs there. They arrive as purchase_reported — a separate, zero-weight signal excluded from model training, because a browser cannot prove a sale. They are for attribution and revenue reporting. To have verified orders as well, connect Shopify in Integrations with read_orders. The verified order then supersedes the browser’s report rather than adding to it: both key on the same order id, so a sale is never counted twice.

​
Placements

A strip placed in the theme decides only where it appears. What it serves, how many items, and how the card reads are decided by the placement in the console — so those change without a theme edit or a deploy. A placement the console does not recognise still renders, on your workspace defaults. Renaming one never blanks a live page.

​
Privacy

Where your shop has Shopify’s customer privacy API and a visitor has not allowed analytics, the widget keeps rendering recommendations but stops describing the visitor: cart and customer are withheld. Only the customer id is ever sent, and it is hashed with a per-workspace key before storage. No name, email or address leaves the page.

​
Troubleshooting