Skip to main content

Shopify

Ealyx provides a native Shopify App that enables the trade-in experience directly within your store.

Setting up Ealyx on a Shopify website requires completing three mandatory steps:

  1. Request the App and your credentials: You can obtain the App and your credentials from your Account Manager or request them through our Portal.
  2. Install the App in your Shopify store.
  3. Configure the blocks according to our integration guidelines.

Installation and Activation of the Ealyx App

Once you have access to the App, you must authenticate your store to activate it.

  1. In your Shopify admin panel, go to Apps → Ealyx.
  2. When opening the App, you will see the authentication panel.
  3. Enter your credentials and click “Save”.

After saving, the App will display the authenticated view, similar to the example below:

Add & Configure the Ealyx Blocks

All Ealyx functionality is inserted through the Shopify Theme Editor, without any code snippets.

Before adding individual blocks:

  1. Go to Online Store → Themes
  2. Click Edit theme on your active theme.

Once inside the Theme Editor, follow the block-specific instructions below.


Ealyx Block Types & Configuration

Below you will find:

  • How to add the Ealyx block to each page
  • How to configure it
  • Recommended positions
  • Best-practice guidance

Home Page

The Ealyx Block on the Home page allows you to highlight the trade-in benefit prominently at the beginning of the shopping journey.

How to Add

  1. Inside the Theme Editor, open the Home page template.
  2. Select the corresponding section → Before your Header.
  3. Click add Block.
  4. In the apps section, select Ealyx App.

💡 You may also add the same Ealyx Block to Collections, Product, and Cart pages for consistent messaging.

Configure the Ealyx Block

Configuration options include:

  • Component type → Banner
  • Full-width toggle → On
  • Upper & lower padding → 10px
  • Visibility → Mobile and Desktop

These settings appear in the right-side configuration panel.

Place the block:

  • At the top of the Home page
  • Directly under the Shopify Announcement Bar (optional)

Why:
Placing the block here ensures maximum visibility for the trade-in benefit.


Product Page

The Ealyx Block on product pages displays the trade-in value directly where users make purchase decisions. This block is highly conversion-oriented.

How to Add

  1. In the Theme Editor, switch to the Product template.
  2. Select the corresponding section → Below the Buy buttons.
  3. Click add Block.
  4. In the apps section, select Ealyx App.

Configure the Ealyx Block

Settings include:

  • Component type → Product Widget
  • Full-width toggle → On
  • Upper & lower padding → 10px
  • Visibility → Mobile and Desktop

Drag the block to position it:

  • Below the More payment options text, or
  • Above the “Add to cart” button

Why:
At this stage, shoppers are evaluating affordability. Showing the trade-in benefit here maximizes conversion.


Cart Page

The Ealyx Block on the Cart page lets customers review the trade-in option before checkout.
If the user already completed a valuation, the block also shows the device being traded in and the discount applied.

How to Add

  1. In the Theme Editor, switch to the Cart template.
  2. Select the corresponding section → At the bottom of the cart section
  3. Click add Block.
  4. In the apps section, select Ealyx App.

Configure the Ealyx Block

Settings include:

  • Component type → Cart Summary
  • Full-width toggle → On
  • Upper & lower padding → 10px
  • Visibility → Mobile and Desktop

Place the block:

  • At the bottom of the Cart page

Why:
Users reviewing their total should immediately see how a trade-in can reduce the checkout amount.

Additionally, if a user already initiated a trade-in, this ensures they see:

  • The product they are selling
  • The discount applied in the order summary

Additional Required Step (Cart Page Only)

The Cart block requires adding a small Liquid snippet manually inside your theme code.

Where to add the code

  1. Go to Online Store → Themes → Edit Code
  1. Open: snippets/cart-summary.liquid

  2. Find the element: <div class="cart__summary-totals">

  3. Add this snippet inside that element, just before the closing </div>: <div class="ealyx-teaser" data-type="cart-summary"></div>

⚠️ Important: if this step is skipped, the Cart Widget will not appear even if enabled.

Checkout Blocks (Payment Page & Thank You Page)

Ealyx includes two additional widgets that appear during the final stages of the purchase flow:

  • Checkout Block (Payment Page)
  • Thank You Page Block

These widgets are not added through the Theme Editor.
They must be added through the Shopify Checkout Editor.

⚠️ Important limitations

  • The Payment Page widget is only available for Shopify Plus merchants, because Shopify restricts checkout customisation.
  • The Thank You Page widget is available for all merchants.

How to Add

  1. In Theme Editor, switch to the Checkout and customer accounts template.
  2. Go to Apps
  3. Search for Ealyx App.
  4. Select ealyx-checkout → Add to → Checkout
  5. Select ealyx-thankyou → Add to → Thank you

Place the widget:

  • Directly below the Shipping Method block and above the Payment section

Why: This placement ensures the user sees their trade-in benefit right before selecting a payment method, increasing confidence and reducing friction at the most critical step of the checkout process.

⚠️ Note: This block is only available for Shopify Plus merchants.

Place the widget:

  • At the top of the Thank You page, just below the confirmation header

Why: Displaying the widget immediately after order confirmation reinforces the user’s trade-in action and provides a clear next step. This increases post-purchase engagement and ensures users know their trade-in has been successfully registered.

Save and Test

After configuring any widget:

  1. Click Save in the Theme Editor
  2. Open your storefront in a new tab
  3. Verify that the widget loads and interacts correctly with Ealyx