Everything your customers see and use: the group buy product page, the shop, the cart and checkout, their account area, and the shortcodes and blocks you can place anywhere.
The product page
A group buy’s product page shows the group price next to the regular price (crossed out), and a campaign box under the price with:
- Status: Active, Scheduled, Successful or Failed, plus the Goal reached and Ending soon badges when they apply.
- Saving: “Save 25% with the group price”, when a regular price is set.
- Progress bar: committed units towards the goal, in your chosen colour, announced to screen readers (“140 of 200 units”).
- Count: “140 / 200 units committed (70%)”.
- Units needed: “60 more units needed to reach the goal”, or “Goal reached! The deal is on.”
- Units left: shown when the campaign has a maximum quantity or limited stock.
- Per-customer rule: “Order between 2 and 20 units per customer”, or “Minimum order: 2 units per customer”.
- Your quantity: “You have joined with 6 units”, for a customer who has already joined.
- Countdown: “Ends in 3d 4h 12m 5s”, or “Starts in …” for a scheduled campaign. Without JavaScript, the date is shown instead. When it reaches zero, the page reloads once to show the new state.
- Terms text: by default, “You pay now. If the goal is not reached by {end date}, your payment is refunded automatically.”
- Share links: WhatsApp, Facebook, X, Email and Copy link, so customers can help the group reach its goal. They are plain links, and no third-party scripts are loaded.
- Recently joined (optional, off by default): the latest participants as first name and last initial, for example “Jane D. joined with 3 units · 2 hours ago”.
Below the box, the quantity field and the Join group buy button work like a simple product’s add-to-cart form. The quantity field starts at the customer’s minimum and stops at their maximum.
After a campaign closes, the box says “This group buy reached its goal and is now closed” or “This group buy ended without reaching its goal”, and the add-to-cart form is removed. A customer who has already joined with the maximum quantity sees “You have already joined this group buy with the maximum quantity allowed per customer” instead of the form.
With Pro, the box can also show the price tiers, a password form for private campaigns, and a waitlist form once the campaign has ended.
The shop and category pages
- Badge: the “Sale!” badge on group buy products is replaced with Group buy (or your own text), in classic themes and in the product blocks of block themes.
- Progress: a compact progress bar with “140 / 200 units” and the Goal reached / Ending soon badges under the product title. You can switch it off in the settings.
- Button: the loop button says Join group buy (or View deal once the campaign isn’t accepting orders) and opens the product page, where the customer chooses a quantity.
Quantity rules
Every rule is checked on the server: when adding to the cart, in the cart, and at checkout, in both the classic and the block checkout.
- Only while active: a scheduled or closed campaign doesn’t accept orders.
- Minimum per customer: a customer’s first order must reach the minimum. Once they’ve joined, they can top up by any quantity.
- Maximum per customer: counted across all of the customer’s orders in the campaign, matched by their account and their billing email, and checked again at checkout once the billing email is known.
- Maximum quantity and stock: a customer can’t order more than the units left.
The cart and checkout
- Separate orders: by default, group buy items can’t share a cart with regular products. You can allow mixed carts in the settings.
- Price: the group price is charged, or with Pro’s tiered pricing, the current tier price, settled when the campaign closes.
- Block checkout: the Cart and Checkout blocks respect the minimum and maximum quantities, and checkout errors appear inline.
- Payment: customers pay in full at checkout with any of your gateways.
After checkout
- The order shows the status Awaiting group, and each group buy item shows its state, for example Group buy: Awaiting goal, on the thank-you page, in My Account → Orders and in the emails.
- Downloadable files unlock only when the deal is confirmed.
- The customer is emailed when they join, shortly before the campaign ends, when the deal is confirmed, or when it fails and they’re refunded. See Group buy emails.
My Account → Group buys
Customers get a Group buys tab in My Account, after Orders, listing every campaign they joined:
| Column | Shows |
|---|---|
| Group buy | The product, with its end date while it’s running. |
| Your units | The units they committed across all their orders. |
| Progress | The group’s progress towards the goal, for the current round. |
| Status | Waiting for the goal, Confirmed, Refund pending, Refunded or Cancelled. |
Campaigns are matched by account and by billing email, so orders placed as a guest with the same email show up too. If the tab shows a 404, go to Settings → Permalinks and click Save Changes.
Shortcodes and blocks
Place group buys anywhere: on a landing page, in a post, or in a block theme template. Each shortcode has a matching block in the WooCommerce category of the block editor, with the same options in the block settings and a live preview.
Group buy progress
[tribuy_progress id="123" style="full"]| Attribute | Default | Description |
|---|---|---|
id | current product | The group buy’s product ID. Leave it out inside a product template. |
style | full | full shows the whole campaign box with the countdown and share links; compact shows only the progress bar and count. |
Block: Group Buy Progress, with a group buy picker and a Compact progress bar only toggle.
Group buy countdown
[tribuy_countdown id="123"]A live “Ends in …” or “Starts in …” countdown. Nothing is shown once the campaign has ended. Block: Group Buy Countdown.
Group buy campaigns
[tribuy_campaigns status="active" limit="12" columns="4" orderby="end_date"]A product grid of campaigns, using your theme’s product cards with the group buy badge and progress.
| Attribute | Default | Description |
|---|---|---|
status | active | active, scheduled, successful, failed or any. Separate several with commas, e.g. active,scheduled. |
limit | 12 | How many campaigns to show (up to 100). |
columns | 4 | Columns, 1–6. |
orderby | end_date | end_date (ending first), popularity (most units committed), date (newest) or title. |
order | depends | asc or desc, to reverse the default order. |
Block: Group Buy Campaigns, with the same options. When no campaign matches, it shows “There are no group buys to show right now.”
Themes and styling
Group buys use your theme’s single product template. On block themes such as Twenty Twenty-Five, the campaign box is printed inside the WooCommerce Single Product template without any changes. To change the markup, override the templates. The colour comes from the Progress bar color setting, exposed as the CSS variable --tribuy-color:
.tribuy-campaign { border-radius: 0; }
.tribuy-progress { height: 12px; }
.tribuy-flag--ending-soon { background: #fde68a; color: #78350f; }The stylesheet has a right-to-left version.