Settings
Overview
All plugin settings are located at WooCommerce > EU VAT OSS > Settings. The settings page is organized into three tabs: General, Notifications, and Display.
General settings
Home country
The EU member state where your business is established. This is the foundation of all order classification — orders within this country are classified as Domestic, while orders to other EU states are classified as cross-border.
Choose your country from the dropdown list of 27 EU member states. If your business moves to a different EU country, update this setting and the plugin will reclassify future orders accordingly. Existing orders retain their original classification.
VAT registration number
Your business VAT number (e.g., DE123456789 for Germany, FR12345678901 for France). This is displayed on order meta data and used for reference in reports. The plugin validates the format based on your selected home country.
Fiscal year start
By default, the threshold tracking follows the calendar year (January 1 to December 31), which aligns with the EU OSS rules. This setting is informational and used for report date presets.
Order statuses
Select which WooCommerce order statuses count toward the threshold. By default, Processing and Completed orders are included. You may want to exclude Processing if you prefer to count only shipped orders.
Notification settings
Enable notifications
A master toggle to turn all email notifications on or off.
Recipients
A comma-separated list of email addresses that receive all notification types. Defaults to the WordPress admin email address.
Warning threshold
The percentage of the EUR 10,000 threshold at which the “approaching” alert is sent. Default is 80%. You can set this anywhere from 50% to 95%.
Digest frequency
How often the summary digest email is sent. Options are:
- Daily — Sent every morning.
- Weekly — Sent every Monday morning (default).
- Monthly — Sent on the 1st of each month.
- Disabled — No digest emails.
For more detail on notifications, see the Email notifications documentation.
Display settings
Cart notice
When enabled, a notice is displayed on the cart page informing EU customers that VAT may apply based on their delivery country. You can customize the notice text.
Checkout VAT field
Controls whether a VAT number field is shown at checkout. When enabled, business customers can enter their VAT number to be classified as B2B. Options:
- Show for EU countries only — The field appears only when the billing country is an EU member state other than your home country (default).
- Always show — The field is visible for all countries.
- Hide — The field is not displayed.
Order emails
When enabled, the order confirmation email sent to customers includes their order’s EU VAT classification and applicable VAT information.
Tips
- Set your home country first — All other features depend on this being correct.
- Review settings quarterly — As your business grows, your notification thresholds and display preferences may need adjustment.
- Test the checkout experience — After configuring display settings, place a test order to verify the VAT field and cart notice appear as expected.