Elementor & Gutenberg
Native widgets for Elementor and blocks for the Gutenberg block editor — drag-and-drop auction surfaces into any page.
Elementor widgets
Available when Elementor is active.
| Widget | What it renders |
|---|---|
| Auction List | Filterable grid of auctions (status / type / category) |
| Single Auction | Pulls in a specific auction by ID |
| Auction Countdown | Standalone countdown timer for one auction |
| Auction Search | Search bar for auction lots |
| Top Bidders | Leaderboard widget |
| Auction of the Day | Featured single auction (rotates daily) |
| Recently Won | Public list of recently-paid auctions |
| Live Bid Stream | Real-time scrolling bid activity (use sparingly — heavy) |
| Watchlist | Logged-in user's personal watchlist |
| Wallet Balance | User's balance + top-up CTA |
| Auction Hero | Large featured image + countdown + CTA |
| Stats Counter | Total auctions / bids / users |
Each widget exposes Elementor controls for filters, layout, colors, button text — full customization without code.
Adding a widget
- Open any page in Elementor
- Drag a widget from the Auctions for WooCommerce category
- Configure in the left panel
- Save
Gutenberg blocks
Same widgets, available as blocks:
- Auctions for WooCommerce category in the block inserter
- Each block has a sidebar with filter / layout controls
- Blocks render server-side for SEO / performance
Adding a block
- In the post / page editor, click + to add a block
- Search for "Auction"
- Pick a block (e.g., Auction List)
- Configure in the sidebar
- Update / publish
Block / widget reference
Auction List
Most flexible — used everywhere.
| Setting | Effect |
|---|---|
| Status filter | active / scheduled / ended / paid / all |
| Auction type | all / standard / reverse / sealed / ... |
| Category | WC product category filter |
| Vendor | (multi-vendor) — filter by seller |
| Sort by | end date / start date / price / bid count |
| Limit | Max items shown |
| Layout | Grid / List / Carousel |
| Columns | 1–6 |
| Show countdown | yes / no |
| Show bid count | yes / no |
| Show watchers | yes / no |
| Pagination | yes / no |
Single Auction
| Setting | Effect |
|---|---|
| Auction ID | Specific auction to render |
| Components | Bid form / countdown / history / share / etc. |
| Layout | Two-column / stacked |
Auction Countdown
Standalone — useful for promo pages.
| Setting | Effect |
|---|---|
| Auction ID | Which auction |
| Style | Compact / large / minimal |
| Color stops | Override default thresholds |
| When ended | Show "Ended" / hide / redirect |
Elementor templates
Pre-built Elementor templates ship with the plugin (in /templates/elementor/):
- Auction landing page
- Auction event landing
- Vendor store template
- Customer dashboard
Import via Elementor → My Templates → Import.
Theme builder integration
For Elementor Pro:
- Custom Auction Single template (replaces theme's product template for auction product type)
- Custom Auction Archive template (replaces shop archive when filtering for auctions)
- Custom My Account templates for the auction endpoints
Block patterns
Gutenberg block patterns ship with curated combinations:
- Auction homepage hero (3 columns: featured + active + ending soon)
- Vendor store header (logo + stats + auction list)
- Customer dashboard mosaic
Performance
Blocks / widgets cache their query results:
- 60-second TTL for active-auction queries
- Bust on bid placement (cache invalidation tied to
wkafw_bid_placedhook) - Render full HTML server-side; no JS hydration needed for static blocks
Live-update blocks (countdown, bid stream) hydrate client-side via the same polling mechanism as the auction page.
Other builders
| Builder | Status |
|---|---|
| Beaver Builder | Compatible via shortcodes (Shortcodes) |
| Divi | Compatible via shortcodes |
| Bricks | Use shortcodes inside Bricks elements |
| Visual Composer | Use shortcodes |
| Oxygen | Use shortcodes |
For all of the above, the same set of features is available via Shortcodes — just less drag-and-drop ergonomic.
Common questions
"My Elementor widgets disappeared after a plugin update."
Run Elementor → Tools → Regenerate CSS & Data. Plugin updates may invalidate cached widget definitions.
"Can I create a custom auction page builder template?"
Yes — copy any template from /templates/elementor/ to your-theme/auctions-for-woocommerce/elementor/{name}.json, and import via Elementor.
"Does this work with Gutenberg full-site editing (FSE)?"
Yes — auction blocks work in any FSE template (header, footer, single product). The auction-product type can have its own FSE template.