To limit free samples in Shopify, identify the gift products, set the maximum quantity allowed in one cart, and block checkout when the combined matching quantity exceeds that cap. CartBlock's free-item workflow supports product- or product-tag-based conditions with a quantity check.

This article covers a per-cart limit. It does not claim to enforce a lifetime or per-customer limit across past orders.

Choose your Shopify free-sample limit

Write the rule in one sentence before opening the app. For example:

A cart can contain no more than 2 products tagged free-sample.

Clarify these details:

  • Does the limit apply to each sample SKU or all samples combined?
  • Are automatically added gifts and manually added gifts treated the same?
  • Should the shopper remove extras, or should another app remove them automatically?
  • Does the policy reset with every cart, order, customer, or promotion period?

CartBlock's documented workflow blocks checkout and displays a correction. It does not automatically remove the extra items.

Products or product tags: which should you use?

Use specific products when the promotion has a short, fixed list. Use a product tag when sample SKUs change and every tagged product should count toward the same policy.

Tags reduce maintenance, but they also increase the impact of a tagging mistake. Use a dedicated tag such as free-sample, document who may apply it, and test newly tagged products before promotion launch.

How to limit free samples with CartBlock

  1. Open CartBlock and select Create Validation.
  2. Choose Basic validation, following the current owned guide.
  3. Add an internal title such as Maximum 2 free samples.
  4. Configure the supported cart and checkout scopes where the message should appear.
  5. Write an error message that tells the shopper to remove the extra free item.
  6. In the condition section, choose the specific products or the product tag used for gifts.
  7. Select the documented any matching option.
  8. Enable the quantity condition and set it to trigger above your maximum.
  9. Set the product or tag value.
  10. Save the validation and test both allowed and blocked carts.

Follow the current free-item setup guide for exact UI labels.

Example: allow 2 samples per cart

Suppose three sample SKUs carry the free-sample tag. The policy allows any mix of 2.

Cart Expected result
1 sample A Allow
2 sample A Allow
1 sample A + 1 sample B Allow
2 sample A + 1 sample B Block
3 regular products Allow

Use an error such as:

This offer includes up to 2 free samples per cart. Remove 1 sample to continue checkout.

The message gives the limit and the correction without blaming the shopper.

Test common promotion bypass paths

  • Add gifts from the product page, cart drawer, and any gift picker.
  • Increase quantity with the cart quantity control.
  • Use a direct product URL when the sample is published.
  • Enter checkout through an accelerated button used by the store.
  • Remove the qualifying paid product after a gift is added.
  • Combine different tagged sample products.
  • Change the cart after the rule first appears.

CartBlock enforces the validation condition. If another app adds gifts, test the two apps together in the live theme and checkout flow.

Use the checkout validation troubleshooting guide when a rule appears in one cart path but not another.

Keep product tags predictable

A tag-based Shopify free gift limit is easier to maintain when promotions rotate, but only if someone owns the tag. Shopify explains that tags can group and filter products, and its product-tag guidance recommends a consistent format for larger catalogs.

Use one exact tag such as free-sample, document its spelling, and avoid near-duplicates such as free_sample or sample-free. Before a campaign starts, review the matching products and confirm that paid products are not tagged by mistake. When the campaign ends, decide whether the tag remains a permanent policy marker or should be removed.

SKU means stock keeping unit, the merchant identifier for a specific product or variant. A tag can group several SKUs under one rule, while direct product selection is safer for a small, fixed promotion.

Test app and discount stacking

Suppose a gift app adds sample A after a shopper reaches a cart threshold, while the shopper manually adds sample B from a published product page. If both carry the same policy tag, the intended maximum should still apply to the combined quantity. Test that exact mixed cart; do not assume how two apps exchange cart updates.

Also test these combinations:

  • An automatic discount plus an auto-added gift.
  • A discount code that changes the qualifying subtotal.
  • Two gift apps or campaign widgets active together.
  • Subscription and one-time products in the same cart.
  • A gift removed and re-added after the validation appears.

The goal is to limit samples per cart regardless of the entry path. If the configured quantity condition does not count the group as your policy expects, stop and confirm the current CartBlock behavior before launch.

Monitor the promotion after launch

Record a baseline for successful checkouts and promotion-related support contacts. During the first day, review blocked-cart reports, unexpected tag changes, and whether shoppers understand the correction. Keep a named owner for the tag and rule. When the campaign changes, update the promotion copy, validation limit, and test matrix together.

Per-cart limits vs. per-customer limits

A per-cart rule evaluates the current cart. A per-customer limit must reliably identify the customer and inspect the relevant purchase history or eligibility data.

Do not tell shoppers “one sample per customer” when the implementation only limits each cart. Use “up to 2 samples per cart” in both the promotion copy and error message unless a separately verified system enforces the broader promise.

Frequently asked questions

Can CartBlock remove extra samples automatically?

The current FAQ says the validation blocks checkout under the configured condition. Do not assume it removes products. Tell the shopper what to remove, or use a separate cart-automation workflow where appropriate.

Can I count several sample products together?

The owned guide documents product tags for changing groups of free items. Test whether the configured quantity represents the combined behavior you expect.

Can I limit one free sample per customer forever?

This guide does not make that claim. A current-cart quantity rule and a cross-order customer limit are different implementations.

Limit free samples in Shopify without confusing shoppers

State the cap wherever the gift is offered, enforce the same cap at checkout, and make the correction obvious. Explore CartBlock on the Shopify App Store and use its current free-item guide to build the rule.