What is WooBoost?

WooBoost is a WooCommerce promotion engine for BOGO, free gift, and cart-based promotions built on a simple rule system.

Key Features

• BOGO and free product rewards
• Cart subtotal and quantity conditions
• Multiple rules with priority control
• Optional scheduling and usage limits
• Free gift added automatically when cart conditions are met
• Category-based promotions (e.g. buy from a category, get a reward)
• First-order–only promotions for new customers
• Exclude sale products from promotional rules
• Limit rewards per user or per order
• Seasonal or time-based offers using start and end dates
• Cheapest item automatically selected as a free product
• Promotions that auto-remove when cart conditions are no longer valid

How WooBoost Works

• WooBoost checks all active rules against the current cart.
• Each rule evaluates its conditions independently.
• If a rule’s conditions match, its action is applied.
• Multiple eligible rules can apply to the same cart.
• Rules are executed based on priority order.
• Priority controls execution order, not eligibility.
• Free products are added automatically when conditions are met.
• Rewards are removed if cart conditions are no longer valid.
• Usage limits and exclusions are validated before applying rewards.

Rule Engine Overview

WooBoost evaluates all active rules against the cart and applies every rule that meets its conditions.

• Rules are processed in priority order (lower number runs first).
• Priority controls execution order, not eligibility.
• Multiple rules can stack and apply together.
• Each rule is evaluated independently.
• Rewards are added or removed dynamically as the cart changes.

Requirements & Compatibility

Installing the Plugin

1. Go to WordPress Admin → Plugins → Add New.
2. Upload the WooBoost plugin ZIP file or install it from your source.
3. Click Install Now, then Activate the plugin.

Activation & First Setup

After activation, open the WooCommerce menu entry added by WooBoost to create and manage rules.

Initial Configuration Checklist

• Confirm WooCommerce is active
• Create a test rule and verify in cart/checkout

Rules

A rule defines a promotion. Each rule contains one or more conditions and one or more actions.

Conditions

Conditions determine when a rule is eligible, such as products in the cart, quantity requirements, or cart subtotal.

Actions

Actions define what happens when conditions are met, such as adding a free product or applying a discount.

WooCommerce Compatibility

WooBoost works seamlessly with the classic WooCommerce shop, cart, and checkout flow and is fully supported in these environments.

Rule Eligibility

Rule eligibility controls who can use a promotion and under what customer-related conditions the rule should apply.

• Exclude the rule if any product in the cart already has a sale price.
• Restrict the promotion to logged-in users only.
• Limit the rule to a customer’s first order or first N completed orders.
• Allow the promotion only for selected user roles.

Eligibility conditions are checked before a rule is applied.

Scheduling & Date Rules

Optionally define start and end dates to automatically activate or deactivate a promotion based on a schedule.

Scheduled rules are evaluated automatically and do not require manual enabling or disabling.

Status, User Limit & Priority

These settings control whether a rule is active, how often it can be used, and the order in which it is executed when multiple rules are eligible.

• Status – Set the rule as published or inactive.
• User Limit – Limit how many times a customer can use this rule. Use -1 for unlimited usage.
• Priority – Determines execution order when multiple rules apply. Lower numbers execute first.

Priority controls execution order only and does not prevent other eligible rules from applying.