WooCommerce Auto Apply Coupon Without a Plugin — PHP Snippet + 5 Variations (2026)

By default, WooCommerce requires customers to manually find, type, and apply a coupon code at checkout. This creates friction — and friction at checkout is one of the most common reasons carts get abandoned. If a customer doesn’t know a discount exists, or types the code incorrectly, they either pay full price unnecessarily or abandon the purchase to go searching for a working code.

Automatically applying coupons based on cart conditions removes this friction entirely. The customer sees the discount appear the moment they qualify for it — no code entry required.

This guide provides a complete, working PHP snippet to auto-apply WooCommerce coupons based on cart total, plus five practical variations for the most common promotional use cases: specific products, user roles, free shipping, first-time orders, and seasonal campaigns

Why Auto-Apply Coupons Improve Conversion Rates

Removes a manual step at checkout — Every additional field or action at checkout reduces completion rates. Auto-applied coupons remove the “enter coupon code” step entirely for qualifying customers.

Eliminates coupon code confusion — Customers who don’t know a promo code exists, or who mistype one, either miss the discount or contact support. Auto-apply removes this failure point completely.

Encourages higher cart values — A coupon that activates above a spending threshold (e.g., “spend $100, get 10% off”) gives customers a visible incentive to add one more item to qualify — directly increasing average order value.

Improves perceived value — Seeing “Coupon automatically applied!” at checkout creates a positive, reward-like experience that plain pricing does not.

The Base Snippet: Auto Apply Coupon Based on Cart Total

Add this code to your child theme’s functions.php file, or use the Code Snippets plugin for a more maintainable, theme-independent setup.

php

/**
 * Auto Apply Coupon in WooCommerce Based on Cart Subtotal
 */
add_action( 'woocommerce_before_calculate_totals', 'wpcodex_auto_apply_coupon' );
function wpcodex_auto_apply_coupon( $cart ) {

    if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
        return;
    }

    $coupon_code   = 'SAVE10';   // Your coupon code
    $minimum_amount = 100;       // Minimum cart subtotal to qualify

    if ( $cart->subtotal >= $minimum_amount ) {
        if ( ! $cart->has_discount( $coupon_code ) ) {
            $cart->apply_coupon( $coupon_code );
            wc_add_notice( 'Coupon "' . esc_html( $coupon_code ) . '" automatically applied!', 'success' );
        }
    } else {
        if ( $cart->has_discount( $coupon_code ) ) {
            $cart->remove_coupon( $coupon_code );
            wc_add_notice( 'Coupon removed — minimum order amount not reached.', 'notice' );
        }
    }
}

What changed from a basic version:

• Uses woocommerce_before_calculate_totals instead of woocommerce_before_cart — this hook fires reliably on every cart and checkout calculation, not just the cart page
• Includes the is_admin() / DOING_AJAX check — prevents the snippet from running during admin AJAX requests, which avoids “headers already sent” errors
• Uses wc_add_notice() instead of wc_print_notice() — the correct WooCommerce function for queuing notices that display properly across cart and checkout pages
• Escapes the coupon code with esc_html() in the notice message for output safety

Important: The coupon code SAVE10 must already exist in WooCommerce → Marketing → Coupons. This snippet applies an existing coupon automatically — it does not create the coupon itself.

How the Snippet Works

The function runs every time WooCommerce recalculates cart totals — which happens whenever a customer adds or removes an item, updates a quantity, or loads the cart/checkout page.

1. It checks the current cart subtotal against your defined minimum amount
2. If the subtotal meets or exceeds the minimum and the coupon is not already applied, it applies the coupon and shows a success notice
3. If the subtotal drops below the minimum and the coupon is currently applied, it removes the coupon and shows a notice explaining why

This creates a fully automatic, self-correcting discount that responds in real time to cart changes — no page refresh required beyond the normal cart update.

5 Variations for Common Promotional Campaigns

Variation 1 — Apply Coupon Only for Specific Products

Apply a coupon only when a specific product is in the cart:

php

$target_product_id = 123; // Replace with your product ID
$has_product = false;

foreach ( $cart->get_cart() as $cart_item ) {
    if ( $cart_item['product_id'] == $target_product_id ) {
        $has_product = true;
        break;
    }
}

if ( $has_product && ! $cart->has_discount( $coupon_code ) ) {
    $cart->apply_coupon( $coupon_code );
}

Use case: Bundle promotions — “Buy this product, get 10% off your whole order.”

Variation 2 — Apply Coupon for Specific User Roles

Reward wholesale customers, members, or specific user groups automatically:

php

if ( is_user_logged_in() ) {
    $user = wp_get_current_user();
    if ( in_array( 'wholesale_customer', (array) $user->roles ) ) {
        if ( ! $cart->has_discount( $coupon_code ) ) {
            $cart->apply_coupon( $coupon_code );
        }
    }
}

Use case: Wholesale pricing, membership discounts, employee discounts — applied automatically based on the logged-in user’s role.

Variation 3 — Auto Apply Free Shipping Coupon

Combine the cart total check with a dedicated free shipping coupon (configured as “Free Shipping” type in WooCommerce coupon settings):

php

$free_shipping_coupon = 'FREESHIP';
$free_shipping_minimum = 75;

if ( $cart->subtotal >= $free_shipping_minimum ) {
    if ( ! $cart->has_discount( $free_shipping_coupon ) ) {
        $cart->apply_coupon( $free_shipping_coupon );
    }
}

Use case: “Free shipping on orders over $75” — one of the highest-converting promotional messages in e-commerce.

Variation 4 — Apply Coupon for First-Time Customers Only

Check the customer’s order history and apply a welcome discount only if they have never ordered before:

php

if ( is_user_logged_in() ) {
    $customer_orders = wc_get_orders( [
        'customer' => get_current_user_id(),
        'status'   => [ 'wc-completed', 'wc-processing' ],
        'limit'    => 1,
    ] );

    if ( empty( $customer_orders ) && ! $cart->has_discount( $coupon_code ) ) {
        $cart->apply_coupon( $coupon_code );
    }
}

Use case: “Welcome — here’s 10% off your first order” — applied automatically with zero friction for new customers.

Variation 5 — Seasonal Campaign with Date Range

Apply a coupon automatically only during a defined promotional window:

php

$start_date = '2026-11-25';
$end_date   = '2026-12-02';
$now        = current_time( 'Y-m-d' );

if ( $now >= $start_date && $now <= $end_date ) {
    if ( ! $cart->has_discount( $coupon_code ) ) {
        $cart->apply_coupon( $coupon_code );
    }
}

Use case: Black Friday, Cyber Monday, or any limited-time sale — the coupon activates and deactivates automatically without any manual intervention on the day of the sale.

Auto-Apply Coupon Logic vs. Manual Coupon Entry

Frequently Asked Questions

Where do I add this PHP snippet?

Add it to your active child theme’s functions.php file, or use the free Code Snippets plugin to manage it without editing theme files directly. Never add custom PHP to a parent theme’s functions.php, as theme updates will overwrite it.

Does the coupon code need to exist in WooCommerce already?

Yes. This snippet applies an existing coupon automatically — it does not create one. Go to WooCommerce → Marketing → Coupons and create the coupon code first (e.g., “SAVE10” with a 10% percentage discount), then reference that exact code in the snippet.

Will this work with WooCommerce Blocks (the new checkout)?

Yes. The woocommerce_before_calculate_totals hook used in this snippet fires regardless of whether you use the classic checkout shortcode or the new WooCommerce Blocks checkout, since coupon application happens at the cart calculation level before either checkout type renders.

Can I auto-apply more than one coupon at the same time?

WooCommerce supports multiple simultaneous coupons by default (unless “Individual use only” is enabled on a coupon). You can extend this snippet with multiple conditional blocks, each checking different conditions and applying different coupon codes.

What happens if I deactivate the snippet while the coupon is already applied to a customer’s cart?

The coupon will remain applied to carts where it was already added, since WooCommerce stores applied coupons in the session/cart data independently of the snippet. New carts will not have it auto-applied once the snippet is removed. To remove it from existing sessions, the coupon would need to be manually removed or the cart cleared.

Is this approach better than using a coupon plugin?

For simple, single-condition automation (like this guide covers), a PHP snippet is lightweight and avoids adding another plugin to your site. For complex, multi-rule discount engines — tiered pricing, BOGO offers, role-based pricing across hundreds of products — a dedicated discount rules plugin or custom development becomes more maintainable than a growing collection of PHP snippets.

Need More Advanced WooCommerce Automation?

This snippet handles common auto-apply coupon scenarios well. But if your store needs more advanced logic — dynamic pricing rules, multi-tier discounts synced with your CRM, or automated promotional campaigns triggered by customer behavior — custom development or a dedicated automation plugin is the better long-term solution.

The WP Codex Plugins team builds custom WooCommerce functionality and can also help connect your store’s promotional data to your CRM for targeted, automated campaigns.

Discuss a Custom WooCommerce Solution →

Explore WooCommerce CRM Automation →