Skip to main content
Cookbook WooCommerce Merchant

Launch a Merchant Buy X Get Y Campaign with AI

Describe the offer and the AI builds it in Merchant, checks it against your running promotions, then proves it in a test cart before a customer sees it.

Difficulty Intermediate
Time ~10 min

Prerequisites

Merchant Pro with WooCommerce on a connected site. Turn on AI write access under Merchant > Global Settings, in the WPVibe panel. That toggle only appears when the WPVibe plugin is active.

The prompt
My store runs WooCommerce with Merchant Pro. Discover Merchant's abilities first.

Create a Buy X Get Y campaign: buy [quantity] of anything in [category or product list], get [quantity] free, with the free item being [the cheapest qualifying product, or a specific product]. Run it from [start date] to [end date].

Before you save anything: run merchant/list-campaigns on the buy-x-get-y module and on every other active Merchant promotion module, and tell me whether this new campaign would overlap or conflict with anything already running. Run merchant/get-module-settings with include_schema=true on buy-x-get-y so you are building from its real field contract. Then show me the full configuration you are about to create and flag every assumption you had to make, especially how variable products qualify and whether the discount applies before or after tax. Wait for my go-ahead.

Once it is live, add qualifying products to a test cart at the threshold and one below it, and read back the totals both times so I can confirm it fires exactly when it should and not before. Then tell me how to switch it off.
Already connected?

Skip pasting the full prompt. Drop this into your AI on a site that already has WPVibe:

Run the “Launch a Merchant Buy X Get Y Campaign with AI” recipe from the WPVibe cookbook on my connected site.

Buy X Get Y is the promotion most worth getting right and the easiest to get subtly wrong. One item off on the qualifying quantity and you are giving away stock on orders that were never meant to qualify. The two details that decide it, how variable products count toward the threshold and whether the discount lands before or after tax, are not the ones the setup screen asks you about first.

The AI builds it as a real Merchant campaign, visible and editable in Merchant exactly as if you had made it by hand. The useful part is what it does either side of that. It reads your existing campaigns first and tells you if the new one collides with something already running, and it names the assumptions it had to make instead of deciding quietly. Then it proves the campaign in a test cart, at the threshold and one below it, and reads you both totals.

Fill in the brackets and approve the configuration when it looks right. A promotion that fires one item too early costs real money, and checking the threshold and the item below it takes the AI seconds, so do not skip that step even when the configuration reads correctly. Switching the campaign inactive afterwards is a single control in Merchant, and nothing about your products or orders is changed either way.

Outcome

A live Buy X Get Y campaign in Merchant, checked against your other running promotions and proven in a real cart at the threshold and one below it.