Configure WooCommerce tax rates and classes

WooCommerceAdvanced~25 min

Before you start

A connected store with the WooCommerce integration enabled and its tax read, create, and update abilities turned on. Take a database backup before a large tax change.

Setting up tax is fiddly and easy to get subtly wrong. A reduced-rate class here, a per-country rate there, a compound rule you half remember, all entered through a spreadsheet-style screen where one mistyped percentage quietly overcharges every order in a region.

This lets the agent read your current tax setup, lay your intended rates and classes out as a plan, and make the changes once you approve. It works with classes and rates only, so it never reaches for the store setting that turns tax on or off.

The prompt
I want to set up tax in WooCommerce. Here is what I need: [a "Reduced rate"
tax class, a 20 percent standard VAT rate for [GB], and a 5 percent reduced
rate for the same country]. Do not create anything yet.
First, list the existing tax classes and every tax rate across them, and show
me a plan: which classes are new, which rates are new, and which existing
rates would change. Change nothing on this pass.
Once I approve the plan, create the new tax classes first, then create and
update the rates in small batches, pausing between them. Do not touch any rate
I did not name. At the end, list every tax class and rate you created or
changed.

Why this is safe to run

The first pass reads and compares. Listing your classes and rates changes nothing, so you approve a plan that clearly separates what is new from what would change, with your current rates as the record to fall back on. Classes are created before the rates that depend on them, so the plan applies in an order that holds together.

The recipe writes only what you named. It creates the classes and rates you approve and edits only the rates in the plan, leaving every other rate untouched, and it never enables or disables tax collection for the store, which is a setting outside its abilities. The WooCommerce tax abilities stay off until you turn them on, every write is gated on the manage-WooCommerce capability, and each class and rate is recorded in the Activity Log.

Already connected? You do not have to paste this. Ask your agent for the “configure WooCommerce tax rates and classes” recipe, or just describe the rates you need, and it runs the same plan-then-approve flow on your own store.

How it works

  1. List the existing tax classes and every tax rate across them.
  2. Compare them against the rates you want and mark what to add, change, or leave, writing nothing yet.
  3. Show the full plan of new classes, new rates, and edited rates, and wait for your approval.
  4. Create the approved tax classes first, then create and update the rates in small batches.
  5. Report every class and rate it created or changed.

Questions

Can it turn tax on or off for the whole store?
No. It works with tax classes and individual rates only. Whether tax is enabled at all is a store setting this recipe never touches.
Will it change rates I did not mention?
No. It shows the full plan first and only creates or edits the classes and rates you approve. Everything else is left as it is.