Skip to main content

Exclude certain products from Upcart upsells (AI recommendations & manual)

Use custom JavaScript to exclude specific products from AI-recommended or manual upsells.

Updated over 2 weeks ago

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

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.

Did this answer your question?