Price Guard – User Guide
What the plugin does
Price Guard watches for suspicious changes to the WooCommerce regular price during admin saves.
It does not change frontend pricing rules, discounts, or promotions. Its purpose is to protect the save process when the new regular price looks abnormal compared to the previous stored price.
How anomaly detection works
The plugin checks a save only when:
- the product already has a previous regular price
- the new regular price is different enough to exceed the configured threshold
If the old price is empty or zero, no anomaly check runs.
Supported product types
- simple products
- product variations
Settings overview
Enable anomaly checks
Turns the protection layer on or off.
Anomaly threshold
Defines the percentage deviation that triggers a warning or block.
Examples:
- old price
100, new price120=20% - old price
100, new price5=95%
Action mode
Warning only: saves the new regular price and shows a warningBlock suspicious price changes: restores the previous regular price and shows a blocking alert
Ignore minor changes
Lets you ignore small percentage changes before the main threshold check is applied.
Logging
Stores suspicious events in the internal pag_logs table.
Email notifications
Sends an email when a suspicious price change is detected.
Notification email
Uses a custom address when provided. If left empty, the plugin falls back to the site admin email.
How warnings work
In warning mode:
- the product save completes
- the new regular price is kept
- a warning appears on the relevant admin screen
Use this mode when you want visibility first and enforcement later.
How block mode works
In block mode:
- the suspicious regular price is rejected
- the previous regular price is restored
- an error alert is displayed
This is useful for production stores where accidental price mistakes must be stopped immediately.
Approving an intentional blocked price
In Pro mode, blocked alerts include the Approve this price button.
This is meant for legitimate exceptional changes.
When clicked:
- the blocked regular price is applied immediately
- the page does not need to reload
- the field is synced visually with the approved value
- the event is logged as
Approved by admin
This approval is intentionally narrow:
- it applies to the current blocked change
- it does not disable protection globally
- it does not change your threshold settings
Logs screen
Open:
BiltsevTools > Price Guard Logs
The logs page shows recent events with:
- date
- user ID
- product ID
- old price
- new price
- deviation
- action
Possible action labels include:
WarningBlockedApproved by admin
License workflow
The commercial version includes a license section in the settings page.
Price Guard:
- stores the license key in plugin options
- validates status against the Biltsev license bridge
- caches status locally
- uses a grace period if the license server is temporarily unavailable
Operational recommendations
- Start with warning mode during rollout.
- Test both simple and variation products.
- Review thresholds against your real catalog.
- Turn on logging before enabling block mode in production.
- If using email alerts, confirm SMTP or mail delivery works on the server.
