Rankd Tax Exemption Certificates for WooCommerce provides a complete, audit-ready tax exemption workflow for WooCommerce stores.

Compatibility notice: This plugin cannot guarantee compatibility with plugins that write directly to the WooCommerce customer session object rather than using the standard woocommerce_customer_is_vat_exempt filter. If your store uses such a plugin, this plugin may not function correctly for affected customers. See the Plugin Compatibility section below for details and resolution options.

FREE FEATURES:

Role-based exemption — mark whole user roles (e.g. wholesale, non-profit) tax exempt from one setting (trust-based; Pro adds certificate-backed compliance for role members)
Per-user override on the user profile: Always exempt, Never exempt (hard block), or follow role rules
Tax Exemption status column and filter on the Users list screen
Configurable admin access — choose which roles may manage exemption data
Uninstalling never deletes your data unless you explicitly opt in via a setting
Optional internal admin note field (not visible to customer)
WooCommerce session-level exemption — tax removed at cart and checkout automatically
HPOS (High-Performance Order Storage) compatible
Read-only status notice on My Account Account Details
Settings tab under WooCommerce Settings Tax Exempt Certs
User Switching plugin compatibility
PDF invoice integration (WooCommerce PDF Invoices & Packing Slips, WP Overnight)
Developer filter hooks for external system integration

PRO FEATURES (via Freemius license):

Customer-facing Tax Exemption tab in My Account
Certificate submission form — org name, exemption certificate number, exemption type, country, state/province
Country-aware form — state dropdown and exemption types update dynamically per country
International support — country-specific exemption types for US, CA, AU, GB, IN, all EU member states
PDF and JPG certificate upload (max 5MB, stored in a protected directory served only through a permission-checked download handler)
Pending / Approved / Rejected / Expired / Revoked / Superseded status system
Admin review queue with pagination: WooCommerce Tax Exempt Certs
Approve / reject / revoke workflow — individual and bulk actions
Admin manual certificate entry with Select2 AJAX user search
Enforced expiry — exemption auto-disables on expiry date via WP-Cron
Expired certificate renewal UX — prefilled resubmission form
Renewal grace period — keep exempting while a renewal is under review (configurable)
Past expiry date validation (client-side and server-side)
Configurable expiry warning buffer (default: 30 days, max 90)
Full email suite (WooCommerce template styled):
- Customer: submission received, approved, rejected, expiry warning, expired
- Customer: certificate revoked (optional — disabled by default, enable in WooCommerce Settings Emails)
- Admin: new submission notification
Automated document retention — optionally purge aged certificate files X years after they become inactive, while permanently preserving the certificate record and audit trail
Dashboard widget — pending count, expiring soon alerts, status breakdown, export buttons
CSV exports — expiry report, active accounts, full audit log
Timestamped audit log per user (exportable per-user or full log)

Requirements

WordPress 6.0 or higher
PHP 7.4 or higher
WooCommerce 7.0 or higher (must be installed and active)

WooCommerce is the only required dependency.

Usage

Marking a customer as tax exempt (Free)

Go to Users All Users
Click Edit on any user
Scroll to the Tax Exemption section
Check the Tax Exempt checkbox
Optionally add an internal note
Click Update User

Tax is removed from that customer’s cart and checkout on their next page load.

Certificate submission workflow (Pro)

Customer flow:

Customer logs in and goes to My Account Tax Exemption
Completes the form and uploads their certificate (PDF or JPG)
Receives confirmation email
Status shows as Pending until reviewed

Admin flow:

Admin receives notification email
Goes to WooCommerce Tax Exempt Certs
Reviews the pending submission, views the certificate document
Approves (verifying the expiry date) or rejects (providing a reason)
Customer receives approval or rejection email

Expiry:

WP-Cron runs nightly and auto-expires certificates past their expiry date
Warning emails fire X days before expiry (configurable, default 30 days)
Expired customers see a prefilled resubmission form in My Account
If a renewal is pending review when the old certificate expires, exemption continues for the configured grace period

Role compliance (Pro):

Members of Tax-Exempt Roles are NOT exempted until there is evidence: an approved certificate covering the order’s jurisdiction, or your recorded override
The Role Exempt tab of the review queue lists role members needing attention, with per-row and bulk actions: Add Certificate, Email for Certificate, or Override (“accept the risk”, scoped to all or specific jurisdictions — the decision is written to the audit log)
A certificate request email points the customer to the My Account submission form
If the certificate backing a member later expires or is revoked, they automatically reappear for review

Settings

WooCommerce Settings Tax Exempt Certs:

Tax-Exempt Roles: Users holding any of these roles are automatically tax exempt (free version). In Pro, role members are exempted only once there is evidence on file — an approved certificate covering the order’s jurisdiction, or an override you record — so a role assignment alone never silently removes tax. Individual users can be excluded via the Never Exempt override on their profile. Default: none.

Pro adds:

Expiry Warning (days): How many days before expiry to send the renewal reminder and allow early renewal submissions (1–90).
Admin Notification Email: Where to send new submission alerts.
Customer Contact Email: Address shown to customers when their exemption is revoked.
Renewal Grace Period (days): How long to keep exempting after expiry while a renewal is pending review (0 disables).

Wholesale & Third-Party Compatibility

This plugin includes a developer filter for external systems to opt individual users out of its management entirely.

Example — wholesale plugin integration:

add_filter( 'rankd_tx_skip_user', function( $skip, $user_id ) {
    // Tell this plugin to ignore users managed by your wholesale system.
    if ( has_wholesale_exemption( $user_id ) ) return true;
    return $skip;
}, 10, 2 );

The plugin also supports additional exemption sources via:

add_filter( 'rankd_tx_exemption_sources', function( $sources, $user_id ) {
    if ( has_wholesale_exemption( $user_id ) ) $sources[] = 'wholesale';
    return $sources;
}, 10, 2 );

Exemption is applied if ANY source returns active. This plugin never removes an exemption granted by another system.

Data Storage

USER META (wp_usermeta):

_rankd_tx_is_exempt — String. Per-user override: always, never, or absent (follow role rules). Legacy 1 values from the pre-1.5.0 checkbox are read as always.
_rankd_tx_exempt_note — String. Admin note. Never shown to customer.

CUSTOM TABLES (Pro):

{prefix}rankd_tx_certificates — One row per certificate submission.
{prefix}rankd_tx_audit_log — One row per status change event.

UPLOADS (Pro):

wp-content/uploads/rankd-tax-exempt-certs/
Protected by .htaccess (Apache/LiteSpeed) plus an index.php fallback. Files are served only through a permission-checked PHP download handler. Nginx requires a one-time server rule — see Server Compatibility below.

Invoice Plugin Integration

Tax exemption details are automatically added to PDF invoices for:

WooCommerce PDF Invoices & Packing Slips (WP Overnight) — fires after order details table on invoices, proformas, and credit notes
WooCommerce PDF Invoices (WP Overnight older plugin) — fires after order table
WooCommerce order confirmation and My Account receipt pages — visible to the ordering customer and store managers only

The notice includes: Organization name, Certificate number, Jurisdiction, Certificate expiry date. It always reflects the certificate that covered the order at purchase time, even if the customer’s status changes later.

Developer filters:

rankd_tx_show_invoice_notice — return false to suppress entirely
rankd_tx_invoice_document_types — array of document types to show on (default: invoice, proforma, credit-note)
rankd_tx_invoice_notice_html — replace the full notice HTML (args: $html, $order)

Plugin Compatibility & Tax Exemption Conflicts

Important: This plugin cannot guarantee compatibility with plugins that write directly to the WooCommerce customer session object rather than using the woocommerce_customer_is_vat_exempt filter. These plugins bypass the filter system entirely and no priority adjustment will resolve the conflict.

How this plugin handles conflicts

WooCommerce determines tax exemption via a single boolean flag on the customer session. This plugin hooks into this system at filter priority 20, which means:

Any plugin setting exemption to true at priority 10 or lower will be respected — this plugin will not override it
Any plugin setting exemption to false at priority 10 or lower may prevent this plugin from applying its own exemption, even if the customer is marked exempt here

This is by design. This plugin deliberately avoids overriding other systems that have already made an exemption decision.

Developer integration — excluding users

If you are building or maintaining a plugin that manages tax exemption for certain users, you can tell this plugin to step aside entirely for those users using the rankd_tx_skip_user filter:

add_filter( 'rankd_tx_skip_user', function( $skip, $user_id ) {
    if ( my_plugin_manages_this_user( $user_id ) ) {
        return true;
    }
    return $skip;
}, 10, 2 );

When rankd_tx_skip_user returns true for a user:

The Tax Exemption Override does not appear on their WordPress user profile
This plugin does not fire any checkout exemption logic for them
Their tax status is entirely controlled by your plugin

Recommended approach for site owners

Use rankd_tx_skip_user to exclude users managed by the other plugin. This is the cleanest solution and eliminates the conflict at the source.
Manage each user in only one system. Regular customers through this plugin; special user types, like wholesale customers, through the plugin that handles their exemption.
Check filter priority. If the conflicting plugin uses the woocommerce_customer_is_vat_exempt filter, adjusting its priority relative to this plugin (priority 20) may resolve the conflict. Contact the other plugin’s developer for guidance.

Server Compatibility

Apache / LiteSpeed

Fully supported. The plugin writes an .htaccess file to the certificate upload directory that blocks all direct HTTP access. No additional configuration required.

Nginx

The .htaccess file has no effect on Nginx servers. If your site runs Nginx, add the following block to your server configuration to protect uploaded certificate files:

location ~* /uploads/rankd-tax-exempt-certs/ {
    deny all;
    return 403;
}

The plugin displays a persistent admin notice if it detects an Nginx server or a missing .htaccess file, with instructions for your hosting provider or server administrator. The notice can be dismissed once the configuration is confirmed.

Other servers

A fallback index.php is also written to the directory to prevent directory listing on servers that process neither .htaccess nor Nginx location blocks.

Scheduled Tasks

Certificate expiry enforcement and warning emails run as daily scheduled actions via Action Scheduler — the background job system built into WooCommerce. No hosting configuration, wp-config changes, or extra plugins are required.

You can view, monitor, and manually run the plugin’s scheduled actions at WooCommerce Status Scheduled Actions (search for “rankd_tx”).

As a safety net, if the checks have not completed in over 36 hours the plugin displays an admin notice with a one-click Run checks now button, so a store manager can trigger the expiry check and warning emails immediately from the dashboard.

For additional reliability on very low-traffic sites, a server-side cron job in your hosting control panel is optional hardening:

curl -s "https://yoursite.com/wp-cron.php?doing_wp_cron" > /dev/null<h3>Developer Reference</h3>

Filters:

rankd_tx_skip_user — Return true to exclude a user from this plugin.
rankd_tx_exemption_sources — Add external exemption sources.
rankd_tx_tax_id_labels — Modify the per-country tax ID label map.
rankd_tx_exemption_types_map — Modify the per-country exemption type lists.
rankd_tx_generic_exempt_types — Modify the generic exemption type fallback list.
rankd_tx_settings — Add/modify settings fields.
rankd_tx_review_queue_per_page — Change review queue page size (default 50).
rankd_tx_show_invoice_notice, rankd_tx_invoice_document_types, rankd_tx_invoice_notice_html — see Invoice Plugin Integration.

Actions:

rankd_tx_certificate_submitted — Fires on new submission. Args: $user_id, $cert_id
rankd_tx_certificate_approved — Fires on approval. Args: $user_id, $cert_id, $expiry_date
rankd_tx_certificate_rejected — Fires on rejection. Args: $user_id, $cert_id, $reason
rankd_tx_certificate_revoked — Fires on revocation. Args: $user_id, $cert_id, $reason
rankd_tx_certificate_expiry_warning — Fires on warning. Args: $user_id, $cert_id, $expiry_date
rankd_tx_certificate_expired — Fires on expiry. Args: $user_id, $cert_id

Uninstalling

By default, deleting the plugin via the WordPress admin Plugins screen removes
NOTHING beyond scheduled tasks — deactivating never removes data, and neither
does deleting, unless you explicitly opt in.

To permanently remove all plugin data on uninstall, enable “Remove Data on
Uninstall” at WooCommerce Settings Tax Exempt Certs before deleting the
plugin. With that enabled, uninstalling removes:

All plugin options
All user meta (_rankd_tx_is_exempt, _rankd_tx_exempt_note)
All order meta (_rankd_tx_was_exempt, _rankd_tx_sources, _rankd_tx_cert_id)
Both custom database tables (Pro)
Scheduled cron jobs

Uploaded certificate files are never deleted automatically, even with this
setting enabled — remove them manually if required:
wp-content/uploads/rankd-tax-exempt-certs/

Uploaded certificate files in wp-content/uploads/rankd-tax-exempt-certs/ are NOT automatically deleted as they may be needed for compliance records. Delete the directory manually if required.