Samir Sabri

TaxDebug for WooCommerce helps store owners debug, understand, trust, and report their taxes – especially when using WooCommerce Tax (automated taxes) or other tax calculation services.
<h4>Key Features</h4>
Deep Tax Visibility 
* See exactly how taxes were calculated for every order 
* View applied tax rates, line-item breakdowns, and calculation formulas 
* Understand which service/plugin produced each tax amount (WooCommerce Core, WooCommerce Tax, TaxJar, Avalara)
Issue Detection Engine 
* Automatically detect common tax problems: 
 * No tax collected where expected 
 * Tax charged in non-taxable regions 
 * Rate mismatches vs reference rates 
 * Missing local (county/city) taxes 
 * Tax changes between cart and checkout 
 * Suspected API errors
Beautiful Dashboard & Reports 
* Modern, responsive admin interface 
* Interactive charts showing tax by state, country, and over time 
* KPI cards for total tax, taxable sales, and effective rates 
* Powerful filtering by date, country, state, tax source, and more
Order Explorer 
* Search and filter all orders with tax data 
* View detailed tax debug information for any order 
* Identify orders with detected issues quickly
Accountant-Friendly Exports 
* Export summary reports by country/state 
* Export detailed order-level tax breakdowns 
* Export detected issues for review 
* CSV format compatible with Excel and accounting software
Safe & Non-Intrusive 
* Does NOT modify how taxes are calculated 
* Only observes, logs, and analyzes tax data 
* Works with any tax calculation method
Feedback & Analytics 
* In-app feedback widget to report false positives/negatives 
* Feature request and success story submissions 
* Privacy-first usage analytics (all data stored locally) 
* Deactivation survey to help improve TaxDebug 
* All feedback stored locally – no external tracking
<h4>Compatibility</h4>
TaxDebug works with: 
* WooCommerce Core tax rates 
* WooCommerce Tax (automated taxes via TaxJar) 
* TaxJar plugin 
* Avalara AvaTax 
* Other tax plugins
<h4>Requirements</h4>
<ul>
<li>WordPress 5.8 or higher</li>
<li>WooCommerce 5.0 or higher</li>
<li>PHP 7.4 or higher</li>
</ul>
<h3>Privacy</h3>
TaxDebug stores order tax data locally in your WordPress database. This includes: 
* Order IDs and dates 
* Customer billing/shipping addresses (country, state, city, postcode only) 
* Order totals and tax amounts 
* Tax calculation details
TaxDebug does NOT: 
* Store payment information 
* Store full customer names or personal details beyond address location
Data retention can be configured in Settings. You can also manually clear all logs at any time.
<h4>Feedback Collection</h4>
TaxDebug collects optional feedback to improve the plugin:
<ul>
<li>In-app feedback: Report false positives, false negatives, feature requests, or success stories</li>
<li>Usage analytics: Anonymous local tracking of which features are used</li>
<li>Deactivation survey: Optional one-question survey when deactivating</li>
</ul>
Local Storage: All feedback is always stored locally in your WordPress database.
Optional Remote Sending: You can opt-in to send anonymous feedback to the developer to help improve TaxDebug. This is disabled by default and must be explicitly enabled in Settings.
<h4>What IS Sent (When Opted-In)</h4>
<ul>
<li>Anonymous store UUID (random identifier, NOT your domain)</li>
<li>Feedback type and message</li>
<li>Your email (only if you voluntarily provide it)</li>
<li>Store country and currency</li>
<li>Active tax plugin (e.g., TaxJar, Avalara)</li>
<li>Plugin, WordPress, and WooCommerce versions</li>
<li>Daily aggregated counts: orders logged, issues detected, features used</li>
</ul>
<h4>What is NEVER Sent</h4>
<ul>
<li>Your site URL or domain name</li>
<li>Customer names, emails, or addresses</li>
<li>Order details, totals, or line items</li>
<li>Tax amounts or financial data</li>
<li>Any personally identifiable information (PII)</li>
</ul>
<h4>How to Disable Remote Sending</h4>
Go to WooCommerce → TaxDebug → Settings and turn off “Send Anonymous Feedback”. You can do this at any time. Local feedback storage will continue to work.
<h3>Developer Notes</h3>
<h4>Hooks & Filters</h4>
TaxDebug provides several hooks for extensibility:
Actions: 
* <code>taxdebug_loaded</code> – Fired when TaxDebug is fully loaded 
* <code>taxdebug_order_logged</code> – Fired when an order is logged (params: log_id, order_id, payload) 
* <code>taxdebug_installed</code> – Fired on plugin installation 
* <code>taxdebug_logs_cleaned_up</code> – Fired when old logs are cleaned up
Filters: 
* <code>taxdebug_order_payload</code> – Filter the order payload before logging 
* <code>taxdebug_detected_issues</code> – Add custom issue detection rules
<h4>REST API Endpoints</h4>
TaxDebug provides a REST API under the <code>taxdebug/v1</code> namespace:
<ul>
<li><code>GET /logs</code> – Get tax logs with filtering</li>
<li><code>GET /logs/{id}</code> – Get single log</li>
<li><code>GET /logs/order/{order_id}</code> – Get log by order ID</li>
<li><code>POST /logs/reanalyze/{order_id}</code> – Re-analyze an order</li>
<li><code>GET /issues</code> – Get detected issues</li>
<li><code>GET /stats/dashboard</code> – Get dashboard statistics</li>
<li><code>GET /stats/chart/time</code> – Get time series chart data</li>
<li><code>GET /stats/chart/state</code> – Get tax by state data</li>
<li><code>GET /stats/chart/country</code> – Get tax by country data</li>
<li><code>GET /export/summary</code> – Export summary CSV</li>
<li><code>GET /export/detailed</code> – Export detailed CSV</li>
<li><code>GET /export/issues</code> – Export issues CSV</li>
</ul>
All endpoints require <code>manage_woocommerce</code> capability.
<h4>Database Tables</h4>
TaxDebug creates two custom tables:
<ul>
<li><code>{prefix}taxdebug_logs</code> – Stores order tax log data</li>
<li><code>{prefix}taxdebug_issues</code> – Stores detected issues</li>
<li><code>{prefix}taxdebug_feedback</code> – Stores user feedback submissions</li>
<li><code>{prefix}taxdebug_analytics</code> – Stores usage analytics</li>
<li><code>{prefix}taxdebug_error_logs</code> – Stores internal error logs</li>
</ul>
<h4>WP-CLI Commands</h4>
(Coming in future versions)

TaxDebug for WooCommerce

A tax debugging and reporting tool for WooCommerce. Debug tax issues, understand calculations, and generate audit-ready reports.

Automattic

WooCommerce

royho

WooThemes

Boro Sitnikovski

Joey Kudish

Allen Snook

Jeff Stieler

Mikey Arce

Radoslav Georgiev

Chris Shultz

David Stone

danreylop

Paul Dechov

orangesareorange

ferdev

harriswong

Marcin

nabsul

Shaun Kuschel a11n

Kelly Hoffman

dappermountain

Bartosz B. a11n

Attention: Shipping features have moved to a new dedicated plugin. Download WooCommerce Shipping.
Enable automated taxes 
That’s it! Once you update your tax settings, your store will collect sales tax at checkout based on the store address in your WooCommerce Settings.
Eliminate the need to even think about sales taxes for your store 
Automatically calculate how much sales tax should be collected for WooCommerce orders — by city, country, or state — at checkout.
<h3>External services</h3>
This plugin relies on the following external services:
<ol>
<li>
WordPress.com connection:
<ul>
<li>Description: The plugin makes requests to our own endpoints at WordPress.com (proxied via https://api.woocommerce.com) to fetch automated tax calculations.</li>
<li>Website: https://wordpress.com/</li>
<li>Terms of Service: https://wordpress.com/tos/</li>
<li>Privacy Policy: https://automattic.com/privacy/</li>
</ul>
</li>
<li>
Usage Tracking:
<ul>
<li>Description: The plugin will send usage statistics to our own service, after the user has accepted our Terms of Service.</li>
<li>Script: https://stats.wp.com/w.js</li>
<li>Terms of Service: https://wordpress.com/tos/</li>
<li>Privacy Policy: https://automattic.com/privacy/</li>
</ul>
</li>
</ol>

WooCommerce Tax (formerly WooCommerce Shipping & Tax)


Edit: didn't realize my client had not connected jetpack to a wordpress.com account.  Works fine.  Nice to have a free option for sales tax calculation.



Original review: I couldn't get it work with or without jetpack. Set up a site with only Woo, Jetpack, this plugin and TwentyTwenty.


Needs JetPack installed and connected


Hi Team,



I have the "WooCommerce Shipping & Tax" plugin installed, but I'm not able to find its settings page. There is a Tax tab in WooCommerce settings (***/wp-admin/admin.php?page=wc-settings&tab=tax) but I guess this is the original WooCommerce settings, not the plugin's ones. Could you give me a direct link to the plugin settings (like the one above), please?



Also, could you please advise on what does this plugin actually do (keeping in mind that I don't have the Jatpack plugin installed)?



Regards, Jake.


Plugin settings


Do not try to add things from 3party to your stuff , I do not need to have AI track me and what I do on my site. That site is on my blocklist now (cdn.sift.com) on the server side , host file for any *.sift.com to 127.0.0.10


add_sift_js_tracker

We’re here to help with tax rates: collect accurate sales tax, automatically.

TaxDebug for WooCommerce vs WooCommerce Tax (formerly WooCommerce Shipping & Tax)