Shopify App: Recommendations

The Shopify app supports Relewise recommendations on storefront pages, in Customer Accounts, and in Shopify checkout.

Storefront Recommendations

On storefront pages, the Shopify app supports the following recommendation types out of the box:

Products

• Popular Products
• Purchased with Product
• Purchased with Multiple Products
• Recently Viewed Products
• Personal Products
• Products Viewed After Viewing Product
• Products Viewed After Viewing Content

Content

• Popular Content
• Personal Content
• Content Viewed After Viewing Product
• Content Viewed After Viewing Content
• Content Viewed After Viewing Multiple Products

To implement storefront recommendations, navigate to Theme Customization and choose the page where you want the Recommendations to go. From there, add the desired Recommendations to the page in the same way you would add any other Shopify Block to the section of your page:

Recommendation Settings

General Settings

Once added to your page, configure the Recommendations by selecting it in the theme editor. The available settings are:

• Displayed At Location: Identifies where the Recommendations are displayed so Relewise can report on revenue, troubleshoot, and apply merchandising rules. Supplying clear locations is strongly recommended—reach out to our team if you need help defining them.
• Content Type: Choose whether the Recommendations should recommend Blog posts or Pages when using content-based Recommendations. See the Shopify native content card guide for more information about blog posts and pages.
• Since Minutes Ago: For Popular Products and Popular Content, set how many minutes of engagement history to use when calculating popularity (default is 20,160 minutes, i.e., 14 days).
• Number of Recommendations: Controls how many items appear in the Recommendations (default is 4).

After saving those settings, continue customizing your page as desired. Your shop will be ready to take advantage of Relewise's content and product Recommendations.

Recommendation Block Headings

You can add a heading directly to a storefront recommendation block in the Shopify theme editor. The heading appears above the recommendations and is hidden together with the block when no recommendations are available.

Select the Relewise recommendation block in the theme editor and configure these settings:

• Show heading: Enable this to display a heading for the block.
• Heading: Enter the text to display, such as "Others also bought" or "Popular Products". Leave the field empty to show no heading.
• HTML tag: Choose H2, H3, or p to fit the heading into your page's structure.
• Alignment: Align the heading to the left, center, or right.

You can translate the heading text with Shopify Translate & Adapt. Save your changes when you have finished configuring the heading.

The heading is part of the recommendation block, so you do not need to add a separate Shopify heading block above it.

Filter by Current Collection

Enable Filter by current collection to show only Products from the Collection the shopper is viewing. For example, a Popular Products block on a sale Collection page recommends only Products in that Collection. The existing popularity settings still determine their ranking.

This setting is available for the Popular Products, Personal Products, and Purchased With Cart storefront blocks:

1. Open a Collection template in the Shopify theme editor.
2. Select one of the supported Relewise recommendation blocks.
3. Enable Filter by current collection and save your changes.

The setting is disabled by default. When enabled on a shared Collection template, the same block automatically uses the Collection being viewed, so you do not need to configure a separate block for each Collection.

On other pages, or when no Collection context is available, the setting has no effect. Other filters and recommendation settings still apply. Purchased With Cart also requires a nonempty cart.

Filter by Current Product

Use Filter by current product to recommend Products with the same metafield value as the Product the shopper is viewing. For example, if the viewed Product has custom.series set to Nordic, the block can recommend only Products whose corresponding Relewise Product Data value is also Nordic.

This setting is available for the Popular Products, Personal Products, and Products Others Viewed storefront blocks. Products Others Viewed uses the Products Viewed After Viewing Product recommendation type.

1. Configure the Product metafield to sync with Relewise.
2. Open a Product template in the Shopify theme editor and select a supported Relewise recommendation block.
3. Under Filter by current product, enable Require the same metafield value.
4. In Product metafield, enter the metafield's namespace and Key, such as custom.series, and save your changes.

Enter only namespace.key; the app automatically adds the shop-domain prefix when matching the corresponding Relewise Product Data Key. Each block filters by one metafield and supports text and boolean values.

The setting is disabled by default. When enabled on a shared Product template, the block automatically uses the viewed Product's metafield value, so you do not need to configure a separate block for each series or brand.

If no current Product is available, or its metafield value is missing, empty, or unsupported, the app skips the metafield filter. Other filters and recommendation settings still apply.

Popular Products and Personal Products also automatically exclude the viewed Product when its Product ID is available, even when metafield filtering is disabled.

Context Values

The Shopify app adds Context Values to storefront Recommendation requests. You can use these values in My Relewise merchandising rules to target recommendations to a specific Shopify page or Collection.

Key	Value
PageID	The current Shopify resource ID when available. If Shopify does not provide a resource ID, the app sends the Shopify page type instead.
CollectionID	The Shopify Collection resource ID on Collection pages when available. The app omits this Key on other pages.

The app sends all Context Values as strings. For example, a Recommendation request on a Product page with resource ID 123 includes PageID=123. On a Collection page with resource ID 456, the request includes both PageID=456 and CollectionID=456.

These values apply only to Recommendation requests. The app does not add them to Search requests, including Search requests made by Universal Search. You can inspect the effective values in My Relewise Live View.

Customer Account Recommendations

You can also show Relewise recommendations inside Shopify Customer Accounts.

Customer Account Recommendations render as Relewise app blocks and use the Personal Products recommendation type to show products for the signed-in customer.

Supported Placements

The app currently supports these Shopify Customer Account placements:

• Profile page (customer-account.profile.block.render)
• Orders page (customer-account.order-index.block.render)

Prerequisites

Before you enable Customer Account Recommendations:

1. Install and connect the Relewise Shopify app to the correct Relewise Dataset.
2. Complete the main Shopify app configuration.

Add Customer Account Recommendations

1. Open the Shopify customer account editor.
2. Choose the Customer Account placement you want to customize.
3. Add the Relewise customer account app block.
4. Save your changes.

Configure Customer Account Recommendations

The customer account app block currently supports these settings:

• Number of recommendations: Controls how many products Relewise requests and renders. The default is 4.
• Allow fill if necessary: Allows Relewise to fill with alternative products when needed to reach the requested amount. This is enabled by default.
• Render horizontally: When enabled, recommendations render in a horizontal card grid. When disabled, they render in a vertical list.
• Render variant subtitle: Shows the Shopify Variant title below the product title. This is enabled by default.

How Customer Account Recommendations Behave

• The block only requests recommendations for authenticated customers with marketing consent on the current customer account page.
• Relewise uses the authenticated Shopify Customer ID together with the current language and currency from Shopify Customer Accounts.
• If no recommendations are available, the block does not render.
• Rendered recommendations link directly to the Shopify product page and, when applicable, to a specific Variant.

Checkout Recommendations

You can also show Relewise recommendations directly in Shopify checkout.

Checkout Recommendations render as a Relewise app block in the checkout order summary and use the PurchasedWithMultipleProducts recommendation type to suggest relevant products based on the shopper's current cart.

Prerequisites

Before you enable Checkout Recommendations:

1. Install and connect the Relewise Shopify app to the correct Relewise Dataset.
2. Complete the main Shopify app configuration.

Add Checkout Recommendations in Shopify Checkout

1. Open your Shopify admin.
2. Go to Settings -> Checkout.
3. Open the checkout editor for the checkout configuration you want to update.
4. Add the Relewise checkout app block in the order summary area.
5. Save your checkout changes.

Configure Checkout Recommendations

The checkout app block currently supports these settings in the Shopify checkout editor:

• Number of recommendations: Controls how many products Relewise requests and renders. The default is 4.
• Allow fill if necessary: Allows Relewise to fill with alternative products when needed to reach the requested amount. This is enabled by default.
• Render variant subtitle: Shows the Shopify Variant title below the product title. This is enabled by default.

How Checkout Recommendations Behave

• The checkout app block only renders when there are recommendations for the current checkout.
• Each rendered recommendation can show the Shopify Variant title below the product title.
• When a shopper clicks Add, the selected Variant is added directly to the checkout cart.
• If Shopify rejects the add, the block shows an inline error on that recommendation.
• After a successful add, that recommendation is removed from the block.

Consent and User Context

Checkout Recommendations use Shopify checkout context when requesting recommendations:

• Checkout language
• Checkout currency
• Authenticated customer ID when available
• Relewise temporary ID when available from storefront tracking