MH Free Gifts for WooCommerce

MH Free Gifts for WooCommerce gives store owners a powerful yet intuitive way to reward customers with complimentary products based on custom cart rules.

✨ Key Features

• 💯 COMPLETELY FREE — no upsells or pro version. 100% functional out of the box.
• 🎁 Add Multiple Free Gift Rules — create unlimited gift rules with different conditions and products.
• 🤖 Auto-add Single Gift Rules — automatically add a qualifying gift to the cart when the rule is met, including repeated copies when quantity multiples apply.
• 1️⃣ Optional Non-Stacking Mode — limit customers to gifts from one eligible rule at a time when multiple rules qualify.
• 🔁 Quantity-Based Gift Multiples — scale the number of allowed gifts as customers hit higher cart-quantity multiples.
• 🎯 Dependency-Scoped Thresholds — optionally count quantity and subtotal thresholds against only the matching dependency items instead of the whole cart.
• 🧭 Configurable Checkout Placement — choose where the free gift section appears on classic WooCommerce checkout.
• ✍️ Custom Gift Text & Sizing — change main gift labels and control button/heading font sizes without editing code.
• ⚙️ Smart Rule Conditions & Limits — restrict by subtotal, quantity, date range, product, or user.
• 🧩 WooCommerce Blocks Support — supports both classic and block-based cart and checkout, including shared gift-rule logic and block-aware gift panels.
• 🚀 Lightweight & Optimized — uses a dedicated database table for speed and reliability.

🛒 How It Works

1. Define your free gift rules in the admin — choose eligible products, usage limits, and visibility options.
2. Choose whether subtotal and quantity thresholds should use the whole cart or only the dependency-matching products when you want rules like “buy 2 from category X”.
3. Customers who qualify see a responsive “Choose Your Free Gift” section on the cart (and optionally checkout) page.
4. Customers can either choose a gift manually or let a single-gift rule auto-add it to the cart at $0.
5. MH Free Gifts handles all validation and limits automatically.

Behind the scenes, the plugin intelligently evaluates cart contents, enforces limits, and prevents abuse — creating a seamless, self-contained gifting experience that enhances WooCommerce’s promotion capabilities without extra plugins or conflicts.

Free Gift Admin settings

General Settings * Status (Active or Disabled) * Rule Name (name it something meaningful) – only for admin use * Description (describe your rule) – only for admin use * Select Gifts (Select 1 or more gifts you would like in your gift rule) * Auto-add Gift (Automatically adds the selected gift to the cart when the rule is met. Requires exactly 1 selected gift and uses a base quantity of 1) Display Settings * Display Gifts On (Toggle between Cart or Cart/Checkout mode) * Items Per Row (Cart) (decide how many items in a row you want displayed) Usage Restrictions * Product Dependency (Lock down rule to only allow free gifts to activate if any of these products are in the cart) * Product Category Dependency (Limit rule to selected categories) * Threshold Scope (Choose whether Cart Subtotal, Cart Quantity, and quantity multiples use the whole purchased cart or only items matching the selected product/category dependencies. Example: if your rule is set to Cart Quantity >= 2 and a category dependency is set, Whole Purchased Cart qualifies with 1 matching item + 1 non-matching item, while Matching Dependency Items Only requires 2 matching items.) * User Dependency (Limit the rule to individual customers) * Registered Users Only (Only allowed existing customers to activate the rule) * Number of Gifts Allowed (Restrict the number of gifts a customer can add to their cart) * Cart Subtotal (Is Less Than, Is Greater Than, Is Less Than or Equal To, Is Greater Than or Equal To, Is Equal To) Set you Subtotal threshold amount * Cart Quantity (Is Less Than, Is Greater Than, Is Less Than or Equal To, Is Greater Than or Equal To, Is Equal To) Set you Quantity threshold amount * Repeat Gifts For Quantity Multiples (Scales the Number of Gifts Allowed for each qualifying Cart Quantity multiple) * Valid From (Set valid from date) * Valid To (Set valid to date) Usage Limits * Usage Limit per Rule (Limits how many time the gift rule can be used) * Usage Limit per User (Limits how many times an individual user can use the gift rule) Plugin Settings * Allow Gift Accumulation (When disabled, customers can keep gifts from only one eligible rule at a time) * Checkout Placement (Choose the classic WooCommerce checkout hook used for the free gift toggle) * Cart Heading Text (Customize the main “Choose Your Free Gift” heading) * Checkout Toggle Text (Customize the classic checkout toggle label, for example “Free Gift”) * Add Button Text (Customize the add button label) * Remove Button Text (Customize the remove button label) * Cart Heading Font Size (Adjust the cart/section heading size) * Checkout Toggle Font Size (Adjust the classic checkout toggle size) * Button Font Size (Adjust the Add/Remove button text size) * Button Text / Background / Border Colors (Style the gift buttons) * Button Border Size (Adjust button border thickness) * Button Border Radius (Adjust button corner roundness)

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/gpl-2.0.html