> For the complete documentation index, see [llms.txt](https://responsive-media.gitbook.io/advanced-free-shipping/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://responsive-media.gitbook.io/advanced-free-shipping/conditions-products/collection-item-cost.md).

# Collection Item Cost

## Overview

The **Collection Item Cost** condition applies discounts based on the total value of items from specific collections. This comes in two variants: **Subtotal** (before discounts) and **Total** (after discounts).

## Two Variants

* **Collection Item Cost (Subtotal)**: Calculated BEFORE product discounts are applied.
* **Collection Item Cost (Total)**: Calculated AFTER product discounts are applied.

### When to Use Each

**Use Subtotal when**:

* You want to reward spending on collection items regardless of discounts
* You run frequent product sales and don't want them to affect eligibility

**Use Total when**:

* You want the final value after all discounts
* You want customers to see the "real" amount they're spending

## How It Works

This condition has two parts:

1. **Select collections** - Which collections to count value from
2. **Set threshold** - Minimum value required

**Example**: Select "Premium" collection, threshold $100

* Cart with $120 of premium items → ✓ Qualifies
* Cart with $80 premium + $50 regular items → ✗ Doesn't qualify (only counts premium)

## Available Operators

All numeric operators:

* **Is at least** - Most common
* **Is greater than**
* **Is less than**
* **Is equal to**
* **Is at most**

## Common Use Cases

{% tabs %}
{% tab title="Collection Value Threshold" %}
**Free shipping on $100+ from premium collection**

* Collections: "Premium Products"
* Value **is at least** $100
* Discount: Free shipping
  {% endtab %}

{% tab title="Multi-Collection Promotion" %}
**Free shipping on $75+ from seasonal collections**

* Collections: "Summer", "Spring"
* Value **is at least** $75
* Discount: Free shipping

Counts value from BOTH collections combined.
{% endtab %}

{% tab title="Category-Specific" %}
**Free shipping on $50+ accessories**

* Collections: "Accessories"
* Value **is at least** $50
* Discount: Free shipping
  {% endtab %}
  {% endtabs %}

## Value Calculation

Values are summed from ALL selected collections:

**Example**: Select "Premium" and "Luxury" collections, threshold $100

| Cart Contents             | Collection Value | Qualifies?                   |
| ------------------------- | ---------------- | ---------------------------- |
| $60 premium + $50 luxury  | $110             | ✓ Yes                        |
| $100 premium              | $100             | ✓ Yes                        |
| $80 premium + $30 regular | $80              | ✗ No (regular doesn't count) |

## Subtotal vs Total Example

**Cart**:

* Premium Item A: $50
* Premium Item B: $60
* 20% product discount applied: -$22

**Collection Item Cost (Subtotal)**: $110 (before discount) **Collection Item Cost (Total)**: $88 (after discount)

If threshold is $100:

* Subtotal condition → ✓ Qualifies ($110 ≥ $100)
* Total condition → ✗ Doesn't qualify ($88 < $100)

## Best Practices

{% hint style="info" %}
Use Subtotal if you run frequent product sales - prevents customers from losing free shipping eligibility when sales are active.
{% endhint %}

{% hint style="info" %}
Use Total for simpler customer communication - "Spend $100 after discounts on premium items."
{% endhint %}

{% hint style="info" %}
Combine with overall cart value to ensure profitable orders: "Premium items ≥ $100 AND cart total ≥ $150."
{% endhint %}

## Related Conditions

* [**Collection Item Quantity**](/advanced-free-shipping/conditions-products/collection-item-quantity.md): Base discount on quantity instead of value
* [**Cart Subtotal**](/advanced-free-shipping/conditions-cart-and-order/cart-subtotal.md): Total cart value (all products)
* [**Collection in Cart**](/advanced-free-shipping/conditions-products/collection-in-cart.md): Simple presence check without value threshold


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://responsive-media.gitbook.io/advanced-free-shipping/conditions-products/collection-item-cost.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.