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”)
* Checkout Accordion Default State (Choose whether the classic checkout Free Gift accordion loads open or closed)
* 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