Troubleshooting

Common issues and how to fix them. Try the matching section before opening a support ticket.

Installation

Plugin won't activate

License popup keeps appearing

For local / dev installs, enable dev mode in your hosting setup. For production, enter a valid Envato / Webkul purchase code.

My Account tabs show 404

Resave permalinks: Settings → Permalinks → Save Changes (no changes needed — just save). This flushes WordPress's rewrite rules.

Bidding

"Bid must be at least $X" — but I bid more

Causes:

1. Increment changed mid-auction — the admin updated the increment after bids started, and the form is showing a stale "next bid" suggestion. Refresh the page.
2. Currency rounding — your input rounded down. Use exact values.
3. Cooldown active — you bid too soon after your previous bid. Wait the configured cooldown and retry.

Bid form spinner stuck

"You've been outbid" but I'm still highest

This is a brief race during proxy bidding — the system places your max in increments and the page may briefly show your bid before the proxy fully resolves. Refresh after a second or two.

Anti-snipe extends without a bid

Server vs client clock drift. Sync your server's NTP. The plugin always uses server time, so any drift between users is purely a display effect.

Cron / Lifecycle

Auctions don't end automatically

"Ending soon" emails not arriving

Customer endpoints

/my-account/my-auctions/ returns 404

Resave permalinks. If the issue persists, deactivate and re-activate the plugin to re-register the rewrite rules.

"My Wallet" tab missing

Wallet balance shows wrong number

Recompute the balance from the ledger via Tools → Maintenance → Recompute totals.

Wallet & Payments

Wallet payment option missing at checkout

Auto-charge not firing

Withdrawal stuck in "pending"

The plugin doesn't auto-execute payouts. Admin must:

1. Open Wallet → Withdrawal queue
2. Approve the request
3. Execute the payout via your own Stripe / bank / external method
4. Click Mark Paid

Multi-vendor

Vendor's auction doesn't appear on storefront

Check:

1. Status — is the auction pending (awaiting admin review)?
2. Vendor active — vendor's user role is correct
3. Vendor's product approved — the linked product is published, not pending
4. Multi-vendor adapter detected — see Settings → Multi-Vendor → Detected Adapter

Commissions not recorded

Common causes:

• Seller commission rate is 0 in Settings → Payments
• The WooCommerce order isn't tagged as an auction order
• The vendor isn't detected for that auction (check the multi-vendor adapter)

Database

"Table doesn't exist"

Run Tools → Maintenance → Re-create database tables (with dry-run preview).

"Deadlock found when trying to get lock"

High-concurrency bid contention. Mitigations:

• Enable the bid queue
• Add an object cache (Redis / Memcached)
• Scale your database (read replicas)

Audit chain reports "TAMPERED" at row N

Either:

• Data was manually edited (review WP error log)
• A database backup restore corrupted hash continuity
• A real intrusion (investigate carefully)

If you've confirmed there's no malicious activity, you can re-anchor the chain via Tools → Maintenance → Re-create missing audit chain. This breaks tamper-evidence for events before the re-anchor — only do it if you're certain there's no fraud.

Email

Customers not receiving emails

Standard WordPress email troubleshooting:

1. Check Site Health for "PHP mail" issues
2. Install an SMTP plugin (WP Mail SMTP, FluentSMTP)
3. Verify domain SPF / DKIM / DMARC
4. Check the spam folder
5. Test with WC → Settings → Emails → Test email

For high-volume sites, use a dedicated email service (SendGrid, Postmark, Amazon SES).

Emails arriving but with wrong content

Templates may have been overridden in your theme. Reset to plugin defaults from your theme's email-template directory if you want the stock layout back.

Performance

Auction page slow to load

Dashboard slow

Run Tools → Maintenance → Optimise indexes and Tools → Maintenance → Warm caches. For very large databases (1M+ bids), the dashboard can take 2–5 seconds — page-cache the admin dashboard if needed.

Bid placements taking over a second

Likely lock contention. Mitigations:

• Enable the bid queue
• Scale your database (read replicas)
• Add Redis for hot queries

Front-end / UI

Confetti not appearing

Countdown timer wrong time

Server clock drift. Sync NTP on the server. The plugin always uses server time; any drift between users is purely cosmetic.

Bid form looks broken on mobile

Theme may be overriding plugin styles. Test with the default WordPress theme. If the issue is in the plugin, file a bug report with browser and theme details.

Reset / nuclear options

Full reset (development only)

Use Tools → Maintenance → Reset all auction data with the dry-run preview enabled. Do not run this on production.

Re-create database from scratch

Deactivate the plugin, drop the auction tables manually, then re-activate the plugin to recreate them. Plugin tables are recreated fresh on activation.

Where to get more help

Before reporting a bug, please:

1. Check this page
2. Try the default WordPress theme
3. Disable other plugins one-by-one to isolate the problem
4. Provide your WP version, WC version, plugin version, PHP version, browser, and any error log entries