Settings Reference
Every setting on the Super Speedy → AJAX Prices page, what it does, and when to use it. All settings are stored as WordPress options and default to off / “no”.
| Setting | Option name | Default |
|---|---|---|
| Disable when cart has items | wc_ajax_pricing_disable_with_cart |
no |
| Disable for logged-in users | wc_ajax_pricing_disable_for_logged_in |
no |
| Fix prices for VAT-exempt locations | wc_ajax_pricing_vat_exempt_fix |
no |
| Refresh stock via AJAX | wc_ajax_pricing_refresh_stock |
no |
| Loading text | wc_ajax_pricing_loading_text |
“Loading…” |
Table of Contents
Disable when cart has items
What it does: When enabled, products are rendered with normal (server-side) prices — no AJAX placeholder — for any visitor whose cart is not empty. The check happens both server-side (skips the placeholder) and client-side (the JS reads the woocommerce_cart_hash cookie and bails).
When to use it: Most caching layers stop serving cached pages once a visitor has items in the cart, so those pages already render correct prices server-side and AJAX pricing is unnecessary. Enable this to match that behaviour. It’s also a useful safety net on edge caches that might otherwise serve cached HTML to has-cart visitors.
Disable for logged-in users
What it does: When enabled, logged-in users get normal server-rendered prices with no AJAX placeholder.
When to use it: Most caching layers bypass the cache entirely for logged-in users, so their pages already show correct prices server-side. Enable this so logged-in sessions don’t do AJAX work they don’t need. Leave it off if you serve cached pages to logged-in users (some membership/B2B setups do) and still want per-visitor pricing for them.
Fix prices for VAT-exempt locations
What it does: Removes the base-country VAT that WooCommerce bakes into displayed prices when (a) your store is set to enter prices inclusive of tax and (b) the visitor’s resolved tax location has no matching tax rates. It adjusts variation prices and also keys WooCommerce’s price cache by location so adjusted prices don’t leak between visitors.
When to use it: Only if both conditions apply — you enter prices inclusive of tax, and you sell into countries/regions where no VAT applies. If you enter prices exclusive of tax, or only sell domestically, leave it off. This is the plugin’s most nuanced option — read VAT-Exempt / Tax-Inclusive Pricing before enabling.
Refresh stock via AJAX
What it does: In the same batched AJAX request as prices, also refreshes each product’s stock availability text (“5 in stock”, “Out of stock”) and its loop Add to Cart button. Lets you fully cache product/archive pages while still showing live, per-visitor-correct stock state.
When to use it: Enable if your stock changes often enough that a cached “in stock” label could be wrong, and you want fully-cached pages anyway. The same exclusions as prices apply (logged-in / has-cart, if you’ve enabled those). Off by default because it does a little more work per request. See Live Stock Refresh.
Loading text
What it does: Sets the text historically shown while prices loaded.
When to use it: Rarely needed. The plugin deliberately keeps the cached price visible during the AJAX swap (rather than showing a “Loading…” string) to avoid layout shift, so this text isn’t normally displayed. It’s retained for compatibility and edge cases. Leave it at the default unless you have a specific reason to change it.
Where these are read
These options are consulted in two places that always agree with each other: when the price placeholder is inserted at render time, and inside the AJAX handler that returns the live data. For the developer-facing constants that change plugin behaviour (verbose logging, VAT-exempt trust), see the Developer Reference.
