Skip to main content
⚠️ Important notice This customization only works with Version 1 of the Upcart cart modules. If you recently upgraded your cart to Version 2, these customizations may not work. You will need to use the new selectors provided for Version 2 in the migration guide. If your customizations are not working as expected, you can also revert your cart back to Version 1 instead of using Version 2. We are currently working on new customization templates for Version 2 of the modules, and they will be available soon.

​
Overview

This guide shows how to prevent specific products (e.g. warranties, shipping protection, low-priority items) from appearing in your upsells by excluding them based on Product ID, Product Handle, or Product Tags. You can add this code in Upcart > Editor > Settings > Custom HTML, in locations such as Above announcements/rewards.

​
Exclude by product ID

To find a product ID:
  • Go to Shopify Admin > Products
  • Open the product and copy the long numeric ID from the URL (after /products/)
Example: 
<script>  
  window.upcartModifyListOfUpsells = (upsells) => {  
    var productIDsToExclude = [  
      6958755512477,  
      6958755610781  
    ];  
  
    return upsells.filter(item =>   
      !productIDsToExclude.includes(item.id)  
    );  
  };  
</script>

​
Exclude by product handle

To find a product handle:
  • In Shopify Admin > Products, open the product
  • Scroll to Search engine listing preview > Edit
  • The handle is the last part of the product URL (e.g. ocean-blue-shirt)
Place this script in both Above announcements and Rewards HTML locations: 
<script>  
  window.upcartModifyListOfUpsells = (upsells) => {  
    var productHandlesToExclude = [  
      "ocean-blue-shirt",  
      "yellow-wool-jumper"  
    ];  
  
    return upsells.filter(item =>   
      !productHandlesToExclude.includes(item.handle)  
    );  
  };  
</script>

​
Exclude by product tags

To add or find tags:
  • Go to Shopify Admin > Products
  • Open a product and scroll to the Tags section
  • Tags are case-sensitive
Adding collection product tags in bulk:
  • Go to Shopify Admin > Products
  • Click Search and Filter (F) > Add Filter > Collection
  • Select the collection of the items you want to exclude
  • Select all items (top left checkbox)
  • Click more button (…) > Add Tags
  • Select or type in the tag to apply it to all items in the collection
Example script: 
<script>  
  window.upcartModifyListOfUpsells = (upsells) => {  
    var productTagsToExclude = [  
      "Exclude From UpCart Upsells"  
    ];  
  
    return upsells.filter(item =>   
      !item.tags.some(tag =>   
        productTagsToExclude.includes(tag)  
      )  
    );  
  };  
</script>

​
Best practices

  • Tags must match exactly, including capitalization
  • If you’re filtering upsells in multiple locations (e.g. AI and manual), paste the code in both HTML sections
  • Always test your implementation using Sandbox Mode before going live

​
Need help?

For help writing or debugging advanced customizations, we recommend reaching out to a Shopify Expert. Upcart support does not assist with custom JavaScript, HTML, or CSS implementations. See Shopify Experts