{"id":276260,"date":"2026-03-13T12:57:18","date_gmt":"2026-03-13T12:57:18","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/taxdebug-for-woocommerce\/"},"modified":"2026-03-13T13:00:37","modified_gmt":"2026-03-13T13:00:37","slug":"taxdebug-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/lmo.wordpress.org\/plugins\/taxdebug-for-woocommerce\/","author":23429191,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.1.0","stable_tag":"1.1.0","tested":"6.9.4","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"TaxDebug for WooCommerce","header_author":"TaxDebug Team","header_description":"A comprehensive tax debugging, analysis, and reporting tool for WooCommerce. Helps store owners understand, trust, and report their taxes with deep visibility into tax calculations.","assets_banners_color":"","last_updated":"2026-03-13 13:00:37","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/taxdebug.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":160,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.1.0":{"tag":"1.1.0","author":"hopewise","date":"2026-03-13 13:00:37"}},"upgrade_notice":{"1.0.0":"<p>Initial release of TaxDebug for WooCommerce.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3482523,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3482523,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Dashboard with KPI cards and charts","2":"Order Explorer with filtering","3":"Detailed Order Debug View","4":"Detected Issues list","5":"Settings page"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[232,94,3652,2012,286],"plugin_category":[36,45,59],"plugin_contributors":[257679],"plugin_business_model":[],"class_list":["post-276260","plugin","type-plugin","status-publish","hentry","plugin_tags-analytics","plugin_tags-debug","plugin_tags-reporting","plugin_tags-tax","plugin_tags-woocommerce","plugin_category-analytics","plugin_category-ecommerce","plugin_category-utilities-and-tools","plugin_contributors-hopewise","plugin_committers-hopewise"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/taxdebug-for-woocommerce\/assets\/icon-128x128.png?rev=3482523","icon_2x":"https:\/\/ps.w.org\/taxdebug-for-woocommerce\/assets\/icon-256x256.png?rev=3482523","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p><strong>TaxDebug for WooCommerce<\/strong> helps store owners debug, understand, trust, and report their taxes - especially when using WooCommerce Tax (automated taxes) or other tax calculation services.<\/p>\n\n<h4>Key Features<\/h4>\n\n<p><strong>Deep Tax Visibility<\/strong>\n* See exactly how taxes were calculated for every order\n* View applied tax rates, line-item breakdowns, and calculation formulas\n* Understand which service\/plugin produced each tax amount (WooCommerce Core, WooCommerce Tax, TaxJar, Avalara)<\/p>\n\n<p><strong>Issue Detection Engine<\/strong>\n* Automatically detect common tax problems:\n  * No tax collected where expected\n  * Tax charged in non-taxable regions\n  * Rate mismatches vs reference rates\n  * Missing local (county\/city) taxes\n  * Tax changes between cart and checkout\n  * Suspected API errors<\/p>\n\n<p><strong>Beautiful Dashboard &amp; Reports<\/strong>\n* Modern, responsive admin interface\n* Interactive charts showing tax by state, country, and over time\n* KPI cards for total tax, taxable sales, and effective rates\n* Powerful filtering by date, country, state, tax source, and more<\/p>\n\n<p><strong>Order Explorer<\/strong>\n* Search and filter all orders with tax data\n* View detailed tax debug information for any order\n* Identify orders with detected issues quickly<\/p>\n\n<p><strong>Accountant-Friendly Exports<\/strong>\n* Export summary reports by country\/state\n* Export detailed order-level tax breakdowns\n* Export detected issues for review\n* CSV format compatible with Excel and accounting software<\/p>\n\n<p><strong>Safe &amp; Non-Intrusive<\/strong>\n* Does NOT modify how taxes are calculated\n* Only observes, logs, and analyzes tax data\n* Works with any tax calculation method<\/p>\n\n<p><strong>Feedback &amp; Analytics<\/strong>\n* In-app feedback widget to report false positives\/negatives\n* Feature request and success story submissions\n* Privacy-first usage analytics (all data stored locally)\n* Deactivation survey to help improve TaxDebug\n* All feedback stored locally - no external tracking<\/p>\n\n<h4>Compatibility<\/h4>\n\n<p>TaxDebug works with:\n* WooCommerce Core tax rates\n* WooCommerce Tax (automated taxes via TaxJar)\n* TaxJar plugin\n* Avalara AvaTax\n* Other tax plugins<\/p>\n\n<h4>Requirements<\/h4>\n\n<ul>\n<li>WordPress 5.8 or higher<\/li>\n<li>WooCommerce 5.0 or higher<\/li>\n<li>PHP 7.4 or higher<\/li>\n<\/ul>\n\n<h3>Privacy<\/h3>\n\n<p>TaxDebug stores order tax data locally in your WordPress database. This includes:\n* Order IDs and dates\n* Customer billing\/shipping addresses (country, state, city, postcode only)\n* Order totals and tax amounts\n* Tax calculation details<\/p>\n\n<p>TaxDebug does NOT:\n* Store payment information\n* Store full customer names or personal details beyond address location<\/p>\n\n<p>Data retention can be configured in Settings. You can also manually clear all logs at any time.<\/p>\n\n<h4>Feedback Collection<\/h4>\n\n<p>TaxDebug collects optional feedback to improve the plugin:<\/p>\n\n<ul>\n<li><strong>In-app feedback<\/strong>: Report false positives, false negatives, feature requests, or success stories<\/li>\n<li><strong>Usage analytics<\/strong>: Anonymous local tracking of which features are used<\/li>\n<li><strong>Deactivation survey<\/strong>: Optional one-question survey when deactivating<\/li>\n<\/ul>\n\n<p><strong>Local Storage<\/strong>: All feedback is always stored locally in your WordPress database.<\/p>\n\n<p><strong>Optional Remote Sending<\/strong>: You can opt-in to send anonymous feedback to the developer to help improve TaxDebug. This is <strong>disabled by default<\/strong> and must be explicitly enabled in Settings.<\/p>\n\n<h4>What IS Sent (When Opted-In)<\/h4>\n\n<ul>\n<li>Anonymous store UUID (random identifier, NOT your domain)<\/li>\n<li>Feedback type and message<\/li>\n<li>Your email (only if you voluntarily provide it)<\/li>\n<li>Store country and currency<\/li>\n<li>Active tax plugin (e.g., TaxJar, Avalara)<\/li>\n<li>Plugin, WordPress, and WooCommerce versions<\/li>\n<li>Daily aggregated counts: orders logged, issues detected, features used<\/li>\n<\/ul>\n\n<h4>What is NEVER Sent<\/h4>\n\n<ul>\n<li>Your site URL or domain name<\/li>\n<li>Customer names, emails, or addresses<\/li>\n<li>Order details, totals, or line items<\/li>\n<li>Tax amounts or financial data<\/li>\n<li>Any personally identifiable information (PII)<\/li>\n<\/ul>\n\n<h4>How to Disable Remote Sending<\/h4>\n\n<p>Go to <strong>WooCommerce \u2192 TaxDebug \u2192 Settings<\/strong> and turn off \"Send Anonymous Feedback\". You can do this at any time. Local feedback storage will continue to work.<\/p>\n\n<h3>Developer Notes<\/h3>\n\n<h4>Hooks &amp; Filters<\/h4>\n\n<p>TaxDebug provides several hooks for extensibility:<\/p>\n\n<p><strong>Actions:<\/strong>\n* <code>taxdebug_loaded<\/code> - Fired when TaxDebug is fully loaded\n* <code>taxdebug_order_logged<\/code> - Fired when an order is logged (params: log_id, order_id, payload)\n* <code>taxdebug_installed<\/code> - Fired on plugin installation\n* <code>taxdebug_logs_cleaned_up<\/code> - Fired when old logs are cleaned up<\/p>\n\n<p><strong>Filters:<\/strong>\n* <code>taxdebug_order_payload<\/code> - Filter the order payload before logging\n* <code>taxdebug_detected_issues<\/code> - Add custom issue detection rules<\/p>\n\n<h4>REST API Endpoints<\/h4>\n\n<p>TaxDebug provides a REST API under the <code>taxdebug\/v1<\/code> namespace:<\/p>\n\n<ul>\n<li><code>GET \/logs<\/code> - Get tax logs with filtering<\/li>\n<li><code>GET \/logs\/{id}<\/code> - Get single log<\/li>\n<li><code>GET \/logs\/order\/{order_id}<\/code> - Get log by order ID<\/li>\n<li><code>POST \/logs\/reanalyze\/{order_id}<\/code> - Re-analyze an order<\/li>\n<li><code>GET \/issues<\/code> - Get detected issues<\/li>\n<li><code>GET \/stats\/dashboard<\/code> - Get dashboard statistics<\/li>\n<li><code>GET \/stats\/chart\/time<\/code> - Get time series chart data<\/li>\n<li><code>GET \/stats\/chart\/state<\/code> - Get tax by state data<\/li>\n<li><code>GET \/stats\/chart\/country<\/code> - Get tax by country data<\/li>\n<li><code>GET \/export\/summary<\/code> - Export summary CSV<\/li>\n<li><code>GET \/export\/detailed<\/code> - Export detailed CSV<\/li>\n<li><code>GET \/export\/issues<\/code> - Export issues CSV<\/li>\n<\/ul>\n\n<p>All endpoints require <code>manage_woocommerce<\/code> capability.<\/p>\n\n<h4>Database Tables<\/h4>\n\n<p>TaxDebug creates two custom tables:<\/p>\n\n<ul>\n<li><code>{prefix}taxdebug_logs<\/code> - Stores order tax log data<\/li>\n<li><code>{prefix}taxdebug_issues<\/code> - Stores detected issues<\/li>\n<li><code>{prefix}taxdebug_feedback<\/code> - Stores user feedback submissions<\/li>\n<li><code>{prefix}taxdebug_analytics<\/code> - Stores usage analytics<\/li>\n<li><code>{prefix}taxdebug_error_logs<\/code> - Stores internal error logs<\/li>\n<\/ul>\n\n<h4>WP-CLI Commands<\/h4>\n\n<p>(Coming in future versions)<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>taxdebug-for-woocommerce<\/code> folder to <code>\/wp-content\/plugins\/<\/code><\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<li>Go to WooCommerce \u2192 TaxDebug to access the dashboard<\/li>\n<li>(Optional) Go to Settings to configure logging and retention options<\/li>\n<li>(Optional) Use \"Create Sample Data\" in Settings to generate test orders<\/li>\n<\/ol>\n\n<h4>Quick Start<\/h4>\n\n<ol>\n<li>After activation, TaxDebug will automatically log tax data for new orders<\/li>\n<li>Visit <strong>WooCommerce \u2192 TaxDebug<\/strong> to see the dashboard<\/li>\n<li>Use <strong>Order Explorer<\/strong> to search and filter orders<\/li>\n<li>Click on any order to see detailed tax debug information<\/li>\n<li>Use the <strong>Settings<\/strong> page to analyze existing orders or create sample data<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20taxdebug%20change%20how%20my%20taxes%20are%20calculated%3F\"><h3>Does TaxDebug change how my taxes are calculated?<\/h3><\/dt>\n<dd><p>No. TaxDebug is completely non-intrusive. It only observes and logs tax calculation data - it never modifies tax amounts or rates.<\/p><\/dd>\n<dt id=\"what%20data%20does%20taxdebug%20store%3F\"><h3>What data does TaxDebug store?<\/h3><\/dt>\n<dd><p>TaxDebug stores:\n* Order IDs and dates\n* Customer shipping\/billing addresses (country, state, city, postcode)\n* Order totals and tax amounts\n* Applied tax rates and calculation details<\/p>\n\n<p>TaxDebug does NOT store payment information or sensitive personal data.<\/p><\/dd>\n<dt id=\"does%20taxdebug%20send%20data%20to%20external%20servers%3F\"><h3>Does TaxDebug send data to external servers?<\/h3><\/dt>\n<dd><p>Yes. TaxDebug uses a cloud-based analysis service (api.taxdebug.com) to provide intelligent tax issue detection. This service:\n* Receives order tax data (amounts, rates, locations) for analysis\n* Returns detected issues (e.g., rate mismatches, missing taxes)\n* Does NOT store personally identifiable customer information\n* Does NOT require an account or API key<\/p>\n\n<p>All other data (logs, settings, feedback) is stored locally in your WordPress database. For privacy details, see our <a href=\"https:\/\/taxdebug.com\/privacy\">Privacy Policy<\/a>.<\/p><\/dd>\n<dt id=\"how%20long%20is%20data%20retained%3F\"><h3>How long is data retained?<\/h3><\/dt>\n<dd><p>By default, data is retained for 12 months. You can configure this in Settings (3, 6, 12, or 24 months, or forever).<\/p><\/dd>\n<dt id=\"can%20i%20analyze%20orders%20that%20were%20created%20before%20installing%20taxdebug%3F\"><h3>Can I analyze orders that were created before installing TaxDebug?<\/h3><\/dt>\n<dd><p>Yes! Go to Settings and use the \"Analyze Past Orders\" tool to process existing orders.<\/p><\/dd>\n<dt id=\"what%20are%20%22reference%20rate%20checks%22%3F\"><h3>What are \"reference rate checks\"?<\/h3><\/dt>\n<dd><p>TaxDebug includes approximate tax rate data for US states, Canadian provinces, and EU countries. It compares your effective tax rates against these references to detect potential mismatches. This can be disabled in Settings.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>NEW: In-app feedback widget on all TaxDebug screens<\/li>\n<li>NEW: Feedback admin page (WooCommerce \u2192 TaxDebug \u2192 Feedback)<\/li>\n<li>NEW: Report false positives and false negatives<\/li>\n<li>NEW: Submit feature requests and success stories<\/li>\n<li>NEW: Privacy-first usage analytics (local storage)<\/li>\n<li>NEW: Optional remote feedback sending to developer (opt-in, disabled by default)<\/li>\n<li>NEW: Deactivation exit survey<\/li>\n<li>NEW: Internal error logging for debugging<\/li>\n<li>NEW: CSV export for feedback data<\/li>\n<li>Added opt-in\/opt-out for local analytics in Settings<\/li>\n<li>Added opt-in for anonymous remote feedback sending (off by default)<\/li>\n<li>Clear documentation of what data is\/isn't sent remotely<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<li>Dashboard with KPIs and charts<\/li>\n<li>Order Explorer with search and filtering<\/li>\n<li>Detailed Order Debug View<\/li>\n<li>Issue Detection Engine with 7 detection rules<\/li>\n<li>CSV exports (summary, detailed, issues)<\/li>\n<li>Sample data generator for testing<\/li>\n<li>Support for WooCommerce Core, WooCommerce Tax, TaxJar, and Avalara<\/li>\n<\/ul>","raw_excerpt":"A tax debugging and reporting tool for WooCommerce. Debug tax issues, understand calculations, and generate audit-ready reports.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/276260","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=276260"}],"author":[{"embeddable":true,"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/hopewise"}],"wp:attachment":[{"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=276260"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=276260"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=276260"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=276260"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=276260"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=276260"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}