Title: Vape Duty Manager for WooCommerce
Author: jnysoftware
Published: <strong>September 30, 2026</strong>
Last modified: September 30, 2026

---

Search plugins

![](https://s.w.org/plugins/geopattern-icon/vape-duty-manager-for-woocommerce.svg)

# Vape Duty Manager for WooCommerce

 By [jnysoftware](https://profiles.wordpress.org/jnysoftware/)

[Download](https://downloads.wordpress.org/plugin/vape-duty-manager-for-woocommerce.1.0.0.zip)

 * [Details](https://wordpress.org/plugins/vape-duty-manager-for-woocommerce/#description)
 * [Reviews](https://wordpress.org/plugins/vape-duty-manager-for-woocommerce/#reviews)
 *  [Installation](https://wordpress.org/plugins/vape-duty-manager-for-woocommerce/#installation)
 * [Development](https://wordpress.org/plugins/vape-duty-manager-for-woocommerce/#developers)

 [Support](https://wordpress.org/support/plugin/vape-duty-manager-for-woocommerce/)

## Description

This WordPress.org package is **Vape Duty Manager Free**. It helps UK vape retailers
manage the Vaping Products Duty inside WooCommerce without an external service, 
licence server, or cloud database.

**Included in Free**

 * Unlimited manual duty setup and apply in the WooCommerce product editor
 * Product Prices management for products already enabled in the product editor
 * Full-catalogue duty removal (restore saved base prices across duty-managed products)
 * Storefront product, classic cart, and classic checkout duty notices
 * Discount and coupon duty protection
 * Order-line duty snapshots on customer orders
 * Privacy export, erasure, and optional uninstall cleanup controls
 * WooCommerce tax-configuration safety checks before prices change

**Pro only (separate package)**

 * Calculate & Batches bulk preview, schedule, and apply across the catalogue
 * Per-batch rollback
 * Audit tab, sales and duty reports, and activity log
 * Refund duty review and operational duty ledger
 * Transition stock management
 * Upstream duty recording workflows
 * Manufacturer operating mode
 * Cart and Checkout Blocks integration
 * CSV exports from admin screens

Free includes an **Upgrade** tab that explains the split. Pro is distributed separately.

Important: review calculated prices with your accountant or tax adviser before applying
them. The plugin does not claim HMRC compliance, stock-lot tracking, supplier verification,
or return submission.

### Requirements

 * WordPress 6.5 or newer on a **single-site** installation (multisite is not supported)
 * WooCommerce 8.0 or newer
 * PHP 8.1 or newer
 * A store administrator with the `manage_woocommerce` capability

### Quick start (Free)

 1. **Settings  General** — enable duty pricing and choose the Retailer operating profile.
 2. **Settings  Duty rules** — confirm the duty rate (default £0.22 per ml excluding
    VAT), map a global volume attribute, and choose rounding if required.
 3. **Product editor** — on each SKU, open the Vape Duty panel: set eligibility, enter
    or confirm volume, preview duty, then apply.
 4. **Product Prices** — review and manage base prices for products you have already
    enabled in the product editor.
 5. **Rollback** — use **Remove Vape Duty** when you need to restore saved base prices
    across the catalogue.
 6. **Settings  Customer notices** — optionally show shoppers that prices include vape
    duty (informational only).

### Configure duty rate and volume

 1. Open **Products  Vape Duty  Settings  Duty rules**.
 2. Set **Duty rate per ml** excluding VAT (default `0.22`).
 3. Map a global WooCommerce attribute such as Bottle Size to liquid volume.
 4. Choose **Base price display** and **Rounding** if your shop needs them.
 5. Save settings. Saving never changes catalogue prices.

Supported automatic volume formats include `50`, `50ml`, `50 ml`, and `2.5ml`. Compound
values such as `2 x 10ml` require a manual millilitre override on the product or
variation.

### Mark a product eligible for vape duty

 1. Edit the simple product or variation in WooCommerce.
 2. Open the **Vape Duty** product data panel.
 3. Set **Eligible for Vape Duty** to Applicable (or use Inherit / Excluded as needed).
 4. Enter a valid volume from the mapped attribute or a manual millilitre value.
 5. Save the product. Eligibility and volume are checked before duty can be applied.

The default eligibility rule requires a selected product category **and** a valid
volume. Explicit Applicable can bypass the category requirement but still requires
volume.

### Apply duty manually in the product editor

 1. Open a simple product or variation that is eligible and has valid volume.
 2. In the Vape Duty panel, review the calculated duty-inclusive price.
 3. Click **Apply duty price** (or the equivalent apply control) when you are ready.
 4. Confirm if prompted. The plugin stores base prices and updates the WooCommerce 
    selling price.

There is no SKU limit in Free. Apply products one at a time through the product 
editor.

### Use Product Prices

The **Product Prices** tab is for products **already duty-managed** through the 
product editor.

 * Review duty status, stored base prices, and applied prices.
 * Edit base prices and preview recalculated duty-inclusive prices.
 * Apply confirmed changes per product or in bulk for duty-managed rows only.
 * Product Prices does not bulk-onboard new duty-managed SKUs; enable each product
   in the editor first.

### Remove duty from the catalogue

Free provides **catalogue-wide duty removal** only (not per-batch rollback).

 1. Open **Products  Vape Duty  Rollback**.
 2. Click **Create removal preview** to scan currently duty-managed products.
 3. Review the preview summary and product table.
 4. Type `REMOVE DUTY` to confirm and restore saved base prices.
 5. If you navigate away, return to Rollback and use **Continue preview**, **Regenerate
    preview**, or **Discard preview** as needed.

Products changed outside Vape Duty Manager are skipped by default. Price history
is kept.

### Customer notices

Optional shopper messaging is under **Settings  Customer notices**.

 * Product page: automatic placement or `[vdmwc_duty_notice]` shortcode.
 * Classic cart and checkout: total and/or per-item notices.
 * Notices are informational only; they never change prices or order totals.
 * Cart and Checkout Blocks live integration is **Pro only**.

### Privacy and uninstall

All product, price, history, and order-line duty snapshot data stays on your WordPress
site. No telemetry or external data transfer is used.

 * **Settings  Privacy** — optional automated retention for price drafts and price
   history, plus delete-all-data on uninstall.
 * WordPress personal-data export includes order duty snapshots linked to a customer
   email.
 * Deactivating the plugin does not restore prices. Uninstall retains data unless
   you enable explicit cleanup under Privacy before deleting the plugin.

### Supported product types

Supported: simple products and variations.

Not supported: grouped, external/affiliate, subscription, bundle, composite, mix-
and-match, booking, and other extension-defined product types.

### Troubleshooting

 * Check WooCommerce  Status  Logs for the `vape-duty-manager` source.
 * If volume is rejected, enter a manual millilitre value on the product or variation.
 * If tax configuration blocks apply, review WooCommerce tax settings and the admin
   warning on Settings.
 * Disabling the plugin never restores prices. Use Product Prices or catalogue duty
   removal deliberately.

## Installation

 1. Install and activate the plugin from Plugins  Add New, or upload the ZIP to `/wp-
    content/plugins/`.
 2. Confirm WooCommerce 8.0+ is active. Activation refuses cleanly if WooCommerce is
    missing or if WordPress multisite is enabled.
 3. Open **Products  Vape Duty  Settings**.
 4. Enable duty pricing, set the duty rate per ml, and map your liquid-volume attribute.
 5. Open a product in the WooCommerce product editor, mark it eligible, enter volume
    if needed, and apply duty when ready.

Composer is not required at runtime.

## FAQ

### Does saving settings change prices?

No. Prices change only after you explicitly apply duty in the product editor, confirm
a Product Prices change, or run a confirmed catalogue duty removal.

### Can Free calculate my whole catalogue at once?

No. Bulk **Calculate & Batches** workflows are **Pro only**. Free supports unlimited
manual apply per product in the WooCommerce editor.

### Does Free support per-batch rollback?

No. Free supports full-catalogue duty removal only. Per-batch rollback is **Pro 
only**.

### Are sale prices and coupons supported?

Yes. Plugin-managed percentage sales discount the stored base only and then add 
full duty. Standard WooCommerce coupons are excluded from duty-bearing products 
so duty is not discounted.

### Does the plugin assume 20% VAT?

No. It uses each product’s tax status, tax class, and your store’s WooCommerce tax
configuration.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Vape Duty Manager for WooCommerce” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ jnysoftware ](https://profiles.wordpress.org/jnysoftware/)

[Translate “Vape Duty Manager for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/vape-duty-manager-for-woocommerce)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/vape-duty-manager-for-woocommerce/),
check out the [SVN repository](https://plugins.svn.wordpress.org/vape-duty-manager-for-woocommerce/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/vape-duty-manager-for-woocommerce/)
by [RSS](https://plugins.trac.wordpress.org/log/vape-duty-manager-for-woocommerce/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.0

 * Initial WordPress.org release of Vape Duty Manager Free.
 * Unlimited manual per-product duty calculation and application in the WooCommerce
   product editor.
 * Product Prices management for already duty-managed products.
 * Full-catalogue duty removal to restore saved base prices.
 * Customer duty notices on product pages and classic cart/checkout templates.
 * Privacy export, erasure, and optional uninstall data cleanup controls.
 * WooCommerce tax-configuration and eligibility safety checks before prices change.
 * Separate Pro edition for Calculate & Batches, audit, per-batch rollback, and 
   advanced workflows.

## Meta

 *  Version **1.0.0**
 *  Last updated **1 day ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.5 or higher **
 *  Tested up to **7.1.2**
 *  PHP version ** 8.1 or higher **
 * Tags
 * [duty](https://wordpress.org/plugins/tags/duty/)[pricing](https://wordpress.org/plugins/tags/pricing/)
   [vape](https://wordpress.org/plugins/tags/vape/)[vat](https://wordpress.org/plugins/tags/vat/)
   [woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://wordpress.org/plugins/vape-duty-manager-for-woocommerce/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/vape-duty-manager-for-woocommerce/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/vape-duty-manager-for-woocommerce/reviews/)

## Contributors

 *   [ jnysoftware ](https://profiles.wordpress.org/jnysoftware/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/vape-duty-manager-for-woocommerce/)