← Documentation
Merchant guide

Add Recommend to the storefront

Understand placement, request validation, recommendation events, and verification.

EXPECTED OUTCOMEA storefront block that returns recommendations and records product-discovery activity.
A recommendation block moving from the theme editor to a verified live storefront
A storefront block that returns recommendations and records product-discovery activity.
01

Place the theme app block

Use Shopify’s theme editor to position the Mainspring block on a product template. No theme-code copy and paste is required.

02

Request recommendations

The block requests ranked products for the connected shop, placement, and current product context through the app’s storefront endpoint.

03

Record product discovery

The block records recommendation views and clicks. Order attribution is recorded only when the resulting Shopify order contains the corresponding attribution data.

04

Troubleshoot safely

If the block is empty, confirm the theme placement, catalog sync, eligible inventory, and connected-store status before changing strategy.

Need help?

Start with the symptom and store context.

Open merchant support