This article covers: Creating and publishing a group buy in the backend, allowing customers to join in the frontend at /group-buys, and forming or failing the group after the deadline.
Applicable only when the platform has enabled e-commerce, online purchase, and additionally enabled on-site group buying. Group buying is closed by default and will not automatically open with the activation of e-commerce or online purchases.
What is the difference between group buying and regular products?
A product is about "what to sell", while a group buy is about "under what conditions and within a time frame to sell". A group buy will be attached to an existing product, with a separate group buy price, formation threshold, and deadline set.
| Regular Products | Group Buy | |
|---|---|---|
| Frontend URL | /shop/… | /group-buys/… |
| Main Button | Add to Cart | Join Group Buy |
| Duration | Available for purchase anytime | Has start and end times |
| Transaction Condition | Established upon checkout | Must reach the threshold to form a group; if not reached, it fails the group |
When a product is in a ongoing group buy, regular purchases will be paused, and the product page will display "This product is currently in a group buy, regular purchases are temporarily paused." The product card in the store list will show Group Buying/Join Group Buy labels, clicking it will lead to the group buy page.
Path
Sidebar Commerce → Group Buy Management (/admin/commerce/group-buys), which includes:
- Group Buy Management: List of group buys, with Add Group Buy in the upper right corner.
- Group Buy Categories: Grouping for group buys, allowing filtering by category on the frontend list.
If you cannot see these two items = the platform has not enabled group buying or the account lacks e-commerce permissions, see How to Enable Modules.
Which products can be included in a group buy?
Allowed: Published, Fixed Price purchasable products.
Not allowed (will display 'This product cannot be added to the group buy' when attempting to add):
- Specification type, price lookup table, formula pricing, and other non-fixed price products.
- Online design, requires file upload for printed products
- Inquiry products
The same product can only be in one ongoing group purchase at a time (otherwise it will display 'The product is already in another ongoing group purchase').
Add a new group purchase (step by step)
- Click Add Group Purchase in the group purchase list.
- There are three tabs at the top of the edit page: Settings, Group Orders, Manual Refund. The Settings tab contains the following sections:
Basic
| Field | Description |
|---|---|
| Title | Group name, appears in the list, group purchase page, and notifications |
| URL Alias | Frontend URL segment, e.g., /group-buys/summer-water |
| Description | Content of 'Group Purchase Description' on the group purchase page, can use rich text |
| Cover | Main image for the list and group purchase page; also used as SEO share image if not filled |
| Category | Multiple selections allowed; group purchases without selected categories will still appear in 'All Group Purchases' |
Multilingual site: Titles and descriptions have language tabs, and languages that are not filled will display the content in the primary language.
Products and Prices
- Click Add Product, select the products for group buying (multiple items can be added).
- Choose the algorithm for Group Purchase Price: Fixed Unit Price, Total Group Discount Percentage, or Total Group Discount Amount.
Thresholds and Duration
| Field | Description |
|---|---|
| Start Time/End Time | End time is required |
| Quantity Threshold/Number of People Threshold/Amount Threshold | At least one must be set. Number of people is counted by member accounts, visitors by Email; amount only counts the subtotal of group purchase products |
| Threshold Combination | Must meet all (default) or meet any one |
| Early Group Formation Upon Meeting Threshold | When enabled, the group will form early once the threshold is met |
| Total Group Quantity Limit/Per Person Quantity Limit | Optional; once the limit is reached, no further participation is allowed |
Payment and Notifications
Payment Timing (choose one):
| Options | How Customers Pay | Suitable |
|---|---|---|
| Payment After Group Formation (default) | Leave recipient and invoice information when joining; after group formation, receive notification to pay within payment days at member center 'My Group Purchase' or via notification email link | Concerned about refunds due to group failure, want to lower customer threshold |
| Pay First | Pay when joining; unpaid spots are not reserved and do not count towards threshold | Want to ensure all participants have paid |
Group purchases currently support two payment methods: Green World Online Payment, Bank Transfer.
- Before selecting Payment After Group Formation, the store must first set up Green World or enable bank transfer and fill in at least one receivable account; otherwise, it will display 'Payment After Group Formation requires enabling Green World or enabling bank transfer and filling in a receivable account.' For settings, see How to Set Up Payment and Invoicing, How to Receive Payments Without Integrating Payment Systems.
- Reminder Before Deadline (Hours): How long before the deadline to remind customers who have joined. The switches for Email and LINE notifications are in the store settings (see 'Notifications' below).
SEO
Optional. SEO Title, SEO Description, sharing preview image, and whether to allow search engines to index. If not filled, the group name and description will be used; if the sharing image is not filled, the cover will be used.
- Bottom toolbar: Save Draft (not visible on the front end) or Publish. When published, it will prompt 'After publishing, ongoing products will suspend general purchases.'
Locked after someone joins the group.
After the first group purchase, price, threshold, and payment timing will be locked; the deadline can only be extended, not moved earlier.
What will customers see at the front end?
/group-buyslist: Cards display cover, group purchase price, group progress, countdown, and number of participants; on the right side (mobile at the top), you can filter by group purchase category, and search for group names at the top.- Group purchase page: Displays threshold, progress, deadline, and 'group purchase description'. Fill in your name, email, phone, delivery method (home delivery or store pickup), quantity, and payment method, then click Submit Group Purchase.
- After success, it shows 'Joined the group purchase' and the order number. The group that pays first will proceed to payment.
- Members can view all participated groups, group progress, and payment status in the member center under My Group Purchases (
/account/group-buys); for groups that require payment after formation, click Proceed to Payment here, first seeing the payment confirmation page, then select Credit Card (Green World) or Bank Transfer to make the payment.
Group purchase status on the customer side:
| Status | Meaning |
|---|---|
| Waiting for Group Formation | Joined the group, waiting for deadline or threshold |
| Group Formed, Awaiting Payment | The group has formed after payment, please pay within the payment deadline |
| Paid | Payment completed |
| Not Formed / Refunding for Not Formed / Refunded | Group failed, along with subsequent refund progress |
After the deadline: Group formation, group failure, and refunds
- Automatic settlement: Automatically determines group formation or group failure based on thresholds at the deadline. You can also use Manual group formation, Manual group failure, or Cancel group purchase in the More actions section on the list or edit page.
- Orders waiting for group formation cannot be shipped. The order management will show the status "Waiting for group formation". After the group is formed, unpaid orders will change to pending payment, and only paid orders can start processing (see How to process orders).
- Orders paid by bank transfer can be marked as paid while waiting for the group, but the orders will remain in the waiting state until the group is formed.
- For groups with advance payment, if the amount paid by the deadline does not meet the threshold, the group will fail, and the spots will be released.
- Group failure refunds:
- Supports online refunds for credit cards/e-wallets, which will be automatically refunded according to the original payment method.
- For ATM, convenience store codes, bank transfers, cash on delivery, in-store payments, cash, external card swipes, etc., they will enter the Manual refund tab ("Pending manual refund"), and you need to refund the customers yourself. Failed automatic refunds will also remain here.
- Invoices are issued only after the group is formed.
The Group Order tab shows the list and allows you to Export CSV (order number, buyer, order status, payment status, amount, manual refund status).
Frontend group purchase list settings
The Group Purchase List section in Store Settings (only affects /group-buys):
| Setting | Description |
|---|---|
| Number of items per page in group purchase list, Number of columns in group purchase list for desktop | Layout |
| Default sorting | Ending soon, Latest group opening, Highest completion rate |
| Show group purchase search bar | Default on |
| Show ended groups | Default off; ended groups can still be accessed via URL when off |
| Show progress / Show countdown | Number of items/people/amount and countdown on card |
Notifications
In Store Settings → Notifications, the Group Purchase Notifications section will send out items that are not turned off, notifying only once for the same event:
| Recipient | Notification |
|---|---|
| Customers | Joined the group, group purchase ending soon, group purchase has formed (payment link for unpaid), group purchase not formed |
| Merchants | Someone joined the group, group purchase ending soon, group purchase has formed, group purchase not formed |
Supports Email and LINE (see Email Notifications, How to Set Up LINE Notifications).
When the group purchase feature is disabled
The front-end group purchase page, member center 'My Group Purchases', product card group purchase tags, and the sidebar in the backend will be hidden, and new groups cannot be created or joined; existing group purchases and order data will be retained, and existing groups can still be viewed and closed via the URL. It will be restored once re-enabled.
How to verify
- Create a test group purchase (minimum quantity 2, payment after group formation), public.
- Access
/group-buyswithout a trace, see the card, progress, and countdown; click in to submit a participation request. - The original product page shows general purchase is paused, and the store list product card has a 'Join Group Purchase' tag.
- In the backend order management, this order will be marked as 'Waiting for Group', and shipping will not be possible.
- After reaching the target for another group purchase, click Manual Group Formation: Customers will receive a group formation notification, and Go to Payment will appear in the member center under 'My Group Purchases'.
- Open a test group purchase and Manually Withdraw the Group: Confirm the refund progress or check the Manual Refund tab for that entry.
Common Issues
| Situation | What to do |
|---|---|
| Sidebar does not have group purchase management | The platform has not enabled group purchases, or the account does not have e-commerce permissions |
| "This product cannot be added to the group purchase" | Only fixed price, non-printed/non-quoted products can be used |
| "The product is already in another ongoing group purchase" | End the other group first, or change the product |
| Cannot select to pay after group formation | First set up Green World in the store settings, or enable bank transfer and fill in the receiving account |
| "The deadline can only be extended" | If someone has joined the group, the deadline cannot be moved earlier |
| Group purchase page shows temporarily unavailable for participation | A group that requires payment after formation, but the store currently has no available Green World or bank transfer options |
