Shop Now: On-Store Optional Setup (Manual)


This article is for merchants with the original version of On-Store that requires manual code entry to activate. If customizing the embedded, more automated version, please review the optional setup (embedded) article.

For those with the original On-Store setup who want to switch to the embedded On-Store setup, please review Loop's On-Store switching instructions.


There are several factors for merchants to consider when customizing their Shop Now: On-Store platform. These can range from third-party overlaps, payment and checkout options, information given to or withheld from shoppers, and more.

This article includes optional steps merchants can choose to take to tailor their shoppers’ On-Store experience further. For initial integration instructions or a general On-Store overview, please refer to the original Shop Now: On-Store article

Tip: Loop highly recommends having a developer or engineer present for these customizations.

Modify the shopper experience

Some functions typically available to shoppers may conflict with On-Store interactions and distract from shoppers’ understanding of their return options. Loop recommends modifying these functions’ elements in the store code to prevent confusion, make the checkout process easier, and simplify the On-Store journey while Loop runs.

Loop's recommended modifications include:

  • Hide any alternative payment methods offered alongside the typical Shopify checkout such as AfterPay, Google Pay, Apple Pay, and PayPal. These options are not compatible with Loop’s On-Store experience. This also applies to any buttons or options that offer a Home Try-On program.

  • Alter or hide help chat widgets on the website, as these conflict with the On-Store credit banner. 

  • Adjust any mobile checkout or add-to-cart buttons, as these conflict with the On-Store experience.

  • Deactivate special offer pop-ups and discount code options. Although it’s common to show these when a shopper enters a site, they distract the shopper from adding products to their cart. In addition, these discounts will not apply to items purchased through the On-Store experience.

What are elements?

The best way to modify the functions above is to hide or change their respective elements in the store’s code. Simply put, elements are a single part of a larger group. In this case, the larger group is the code making up the On-Store theme. 

For example: If the store offers alternate payment options such as the ones mentioned above, each option may have a button that shoppers can click to continue their payment (for example, the image below). Each button is an element within the store’s code.

Adjust elements

After activating On-Store, Loop added a Class to the store’s code called “.loop-returns-activated”. This parent Class contains all the elements merchants can modify, separated by hyphens (-). Each element also has a) a place to add its identifier, either a Class or ID, and b) a place showing its display parameters. The example code below shows these places at "ANY ELEMENT CLASSIFIER" and after:

.loop-returns-activated <ANY ELEMENT CLASSIFIER> { 
display: none !important;

Note: The code will contain the store’s specific identifiers for the elements being adjusted, rather than the wording “ANY ELEMENT CLASSIFIER”.

Play the video above or review the written instructions below for an example of how to hide an element.

Visualize the .loop-returns-activated Class

To hide elements, first bring the “.loop-returns-activated” Class into the theme’s code. If a merchant's developers know where the back-end style sheet is, they can add the Class there. Otherwise, follow the instructions below:

  1. Go to Shopify admin > Sales channels > Online Store.

  2. Find the On-Store theme.

    Note: If editing a previously published On-Store theme, do the steps below for the current theme. If making changes to a copy of the On-Store theme before publishing it, do the steps below for the relevant theme under the "Theme Library" section.

  3. Click the ellipsis button on the theme (a set of three periods) > Edit code.

  4. Under the Layout folder, click the file titled “theme.liquid".

  5. Look for “<style>” and “</style>” tags in the code by scrolling or using the finder tool (Control F for Windows, Command F for Mac). Elements will be edited between these style tags.

    If style tags are present, go to Step 6.

    If style tags are NOT present, go to Step 7.

  6. Copy and paste ".loop-returns-activated" right after the <style> tag (the first style tag). Confirm that its placement reflects the snippet under Step 7, then proceed to Step 8.

  7. Copy and paste the snippet below under the " <head> " tag in the code:

     .loop-returns-activated {
     //where the elements will live 
  1. Click Save in the upper right corner of the theme editor window.

Hide the elements

Now, add and adjust any elements within the “.loop-returns-activated” Class, such as those listed under the “Modify the shopper experience” heading. Below is an example of hiding an alternative payment method:

  1. Open a view of the store in a separate tab or window.

  2. Click on a product as if to review it before adding it to the cart.

  3. On this product page, right-click on the chosen element in the checkout view (for example, the Shop Pay button below).

  4. Click Inspect.

  5. Copy the Class or ID highlighted in the Inspector Tool. In rare cases, the identifier for this element could also be a tag within the code.

    Class for the alternative payment element in the Inspector Tool.

  6. Go back to the theme.liquid code file and paste the previously copied Class or ID next to “ .loop-returns-activated ”. Remember to add a period (.) before a Class, and a hash (#) before an ID.

.loop-returns-activated .shop-pay-logo
  1. Change “display:” to “none !important;” to hide any chosen elements.

.loop-returns-activated .shop-pay-logo{
    display: none !important;
  1. Click Save in the upper right corner of the theme editor window.

Note: Merchants can also move these elements around in the code to change where they appear. Again, these actions turn out best with a developer's help.

Tip: To hide an element by way of JavaScript, developers can add the " LoopOnstore.isActive() " flag to any JavaScript code running in their Shopify theme (Shopify > Sales Channels > Online Store > ellipsis button for desired theme > Edit Code > theme.liquid).

Another example

A merchant wants to remove the Shop Pay button and wording from their product pages because they don't want the Shop Pay button to conflict with the On-Store experience.

The merchant would right-click on the page, then click Inspect. The Inspector Tool would show them identifiers for each element making up the Shop Pay section. The image below shows how the Shop Pay button is only one element of all the Shop Pay text on that page.

This article has explained that merchants can nest whichever selectors or elements they want to hide under a .loop-returns-activated CSS rule (CSS means "Cascading Style Sheets", a programming language). Here, the merchant would have to hide multiple elements, since the Class for the Shop Pay button, .shopify-payment-button, would only hide the button but not the rest of the Shop Pay text.

Important: Merchants must create a brand new CSS block for every element they want to hide.

Configure Shopify script discounts

Loop’s Shop Now: On-Store experience can use a merchant’s existing Shopify cart and scripts to determine proper discounts for shoppers’ On-Store orders.

Important: Currently, only cart and order level discounts are compatible with On-Store. Due to script discount structure and variability, support is case by case. Loop cannot guarantee support on script discounts on the line-item level, but will help with configuration where possible.

For questions or help, please contact

How it works

  1. The shopper adds items to their cart through the On-Store experience.

  2. The On-Store code sends any products and applicable discounts from the Shopify cart to Loop’s core API endpoint.

  3. Loop’s core interprets new cart prices and translates them to discounts in Loop's system.

Setup instructions

Follow the GIF (graphics interchange format) visual below, or review the written instructions underneath it, to learn how to configure Shopify script discounts.

To set up discount scripts in On-Store: 

  1. Create a cart in Shopify if one doesn't exist yet.

    Tip: Developers or engineers can help with this.

  2. Again scroll to the bottom of the "theme.liquid" file code in Shopify admin.

  3. Find the “LoopOnstore.init” call added in the original setup instructions

  4. Beneath the key and attach fields, add “full: true,” so that the On-Store snippet reflects the code below:

   LoopOnstore.init ({
     key: 'example api key',
     attach: 'example attach value',
     full: true,
  1. Click Save in the upper right corner of the theme editor window.

Update other customizations

Preserve items in the cart

On-Store sends shoppers to Loop to finish their returns once they click “checkout” in their cart on the store's website. From there, if shoppers use a back button or a back arrow to return to the shop, their carts will show as empty by default, even though the products they selected are still in Loop.

If a cleared cart seems like it may confuse shoppers, merchants can alter their On-Store code to keep the products visible in the website’s cart.

Important: Even preserved carts will not show when clicking the browser’s back arrow, as the browser arrows are separate from Loop’s software and therefore are not included in Loop’s configuration abilities. To see preserved carts when clicking back to the store, click Loop's back button instead, as shown by the image below.

Review the GIF and written instructions below for an example of preserving items in the store's cart.

To preserve items in the store's cart:

  1. Go back to the “theme.liquid” file being modified in Shopify’s theme editor.

  2. Scroll to the bottom of the code.

  3. Find the “LoopOnstore.init” call added in the original setup instructions

  4. Add “ preserveCart: true, ” under the key and attach fields so that the snippet looks like this:

 		key: "example API key",
 		attach: "example attach value",
 		preserveCart: true,
  1. Click Save in the upper right corner of the theme editor window.

Customize the Shop Now redirect

By default, Shop Now directs shoppers to the website’s home page. If a merchant wants to lead shoppers to a specific collection on the site instead, they can use Loop’s event listeners to change that shopper redirect.

Important: Before using the event listener to edit the redirect, check any partnered apps and third parties to ensure they won't interfere with the event listener.

Please review the Events section of the On-Store software development kit (SDK) article, specifically information about adding event listeners for “Loop:Activated” events. Then, copy the code below, paste it into the “theme.liquid” file on Shopify, and replace “your-collection-name” with the name of the store's collection:

document.addEventListener('Loop:Activated', () => {

Change the styling

Although default styles apply to functions such as the checkout button or the credit banner, merchants can alter these to suit their brand’s needs through more code customization. For more information, please reference the Styling section in the On-Store SDK article.

A merchant can also right-click their credit banner and select Inspect to learn which Classes apply to the banner’s code. To add more code to the snippet Classes on the credit banner, work with a developer or contact

Test and publish the changes

After making all desired changes to the code, be sure to test the changes by way of these testing instructions. Once testing is successful, follow the publishing instructions to apply the changes to the On-Store theme.


Can I still edit my theme in these ways, even though I’ve already integrated Shop Now: On-Store? Absolutely! Loop recommends saving a backup of your previous theme and test the On-Store experience thoroughly after making any changes. Refer to the “Test your work” section of the original setup article for instructions.

I made a theme change and now my Checkout button isn’t working correctly through the Shop Now: On-Store experience. What should I do? Review the steps for “Set up a development theme in Shopify“ and “Add a snippet to the development theme“ from the original setup article. If the problem continues, please contact your Merchant Onboarding Manager or

For further questions, please contact your Merchant Onboarding Manager or