The [couponloop] shortcode builds a full coupon listing — columns, paging, and an optional visitor-facing filter bar.
The shortcode #
[couponloop columns="3" perpage="9" filter_order="category,keyword,orderby,perpage"]
| Attribute | Effect |
|---|---|
columns |
Grid columns (default from Options → Display) |
perpage |
Coupons per page, with pagination beneath |
category / exclude_category |
Include or exclude coupon categories (slugs, comma-separated) |
match |
ANY (default) or ALL when listing multiple categories |
orderby / order |
Sort field and direction |
filterbar |
Leave empty to show the filter bar, or use hide to remove it |
filter_order |
Reorder the filter controls |
filter_hide |
Hide specific controls, such as category,perpage, while leaving the bar visible |
A Pro Coupon Loop block provides the same output in the block editor.
The result #
Visitors filter by category, search by keyword, change sorting, and page through — no page reload configuration needed. Category templates let a themed loop page per category share one layout.
The visible controls are category, per-page, order-by, and keyword by default. Coupon Creator Add-ons adds Location and Vendor controls when those features are active; use filter_hide to remove controls you do not want visitors to see.
For a single coupon or a simple recent-coupons strip, the free [coupon] shortcode is still the right tool; [couponloop] is for browseable listings.
