Woo Coupons

Design coupon cards using published WooCommerce coupons as loop items. Display the coupon code, description, discount, and conditions without replacing WooCommerce's own coupon validation.

Enable and Prepare


  1. Activate WooCommerce and BricksUltimate.
  2. Open Bricks → BricksUltimate → Misc, enable Ultimate Woo Query Builder, and save.
  3. Reopen the Bricks editor so the query options refresh.

Create public promotional coupons in Marketing → Coupons and save their discount type, amount, expiry, restrictions, and usage limits. Do not expose private, customer-specific, or recovery coupons through an unrestricted public listing.

Create the Query Loop


  1. Add an outer Section or Block for the heading and layout. Keep the section heading outside the repeated item.
  2. Add an inner Block for one record and enable Use query loop on that Block.
  3. Choose Ultimate Woo Query Builder as the query Type, then choose Coupons under Woo query type.
  4. Enable Disable query merge where offered so the current page's main query does not unexpectedly constrain this custom collection.
  5. Configure the controls below and place the record's dynamic elements inside the repeated Block.
  6. Save and test on the frontend. Builder sample content is not a substitute for the live query result.

Controls and Behavior


ControlHow to use it
Number of items to showSet the page size. Default: 3.
OrderASC or DESC changes the query direction. There is no dedicated coupon Order by selector.
Get only expiry couponsDespite the wording, this means coupons with an expiry timestamp earlier than now: expired coupons, not coupons that will expire in the future.
Exclude expiry couponsExcludes expired coupon IDs while retaining other published coupons, including those without an expiry. It is enabled by default in the control definition.
Using expiry options togetherUse one expiry mode at a time. If both options are stored, the exclusion branch takes precedence. The implementation checks the presence of these settings, so verify the saved frontend result after toggling.

Coupon Dynamic Data

Place these tags inside the repeated coupon card. They read the current coupon, not a product or an order.

PurposeDynamic tag
Code{bu_coupon_code}
Description{bu_coupon_description}
Discount amount / type{bu_coupon_discount_amount} / {bu_coupon_discount_type}
Expiry date{bu_coupon_expiry_date}
Usage count / limit{bu_coupon_usage_count} / {bu_coupon_usage_limit}
Limit per customer{bu_coupon_usage_limit_per_customer}
Spend limits{bu_coupon_minimum_spend_amount} / {bu_coupon_maximum_spend_amount}
Free shipping flag{bu_coupon_grants_free_shipping}

Use the dynamic-data picker for available date formatting. An empty expiry is normal for a coupon with no expiry date. The shipping tag returns a flag, not a complete customer-facing shipping explanation.

Practical Example


Create an Offers page with three coupon cards per page. Put the code in a Heading, the description below it, and a clear spend-limit row. Leave expired-only off and exclude expired coupons. Add a Coupon Form separately if shoppers should enter a code.

Scope and Limitations


This is a published-coupon query, not an eligibility engine. It does not auto-apply or copy codes, hide exhausted coupons automatically, or filter by the current customer. Pagination is supported by the coupon query; connect pagination to this loop and test the next page. For a public site needing a strict promotional whitelist, this provider has no built-in Include control.

Troubleshooting and Testing


If an expired coupon remains visible, check both expiry settings and cached output. A visible coupon can still fail at checkout because of product restrictions, email restrictions, usage limits, or minimum spend. Do not equate listed with redeemable.

Test the populated and empty states, desktop and mobile layouts, and any relevant AJAX refresh. Keep headings and decorative wrappers from leaving empty gaps when no eligible results exist. If a query type is missing, verify the feature toggle, WooCommerce activation, and editor reload before changing the layout.

Related Documentation