> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

⚠️ **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.](/upcart/upcart_v20_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](https://www.shopify.com/partners/directory)