Skip to main content
All shipping, tax, and currency settings for your store are managed from the Shipping & Taxes Console at /admin/ecommerce/shipping. From here you can define flat-rate tiers using range syntax, configure real-time carrier integrations, set US state and Canadian provincial tax rates, manage international VAT, and control how tax is applied per product variant. Non-US/CA merchants can also activate VAT-inclusive storefront pricing from the Merchant Location section.

​
Shipping & Taxes Console

All shipping, tax, currency, and merchant location settings are managed from the Shipping & Taxes Console.

​
Shipping Configuration

​
Flat-Rate Shipping

​
Dynamic Grid Flat-Rate

Define price tiers based on weight, subtotal, or item count using range syntax:
Examples:
  • Min-Max ranges define the lower and upper bounds of each tier (lower-inclusive, upper-exclusive).
  • Other is the fallback price for any value that doesn’t match a defined range.

​
Custom Flat-Rate Options

Pre-defined selectable shipping options for domestic and international destinations:

​
Free Shipping via Coupon

When a coupon has free_shipping = true, all shipping charges are waived at checkout regardless of the shipping method selected.

​
Real-Time Carrier Rates

Real-time rates are provided by carrier plugins. See the Plugins documentation for setup instructions. Merging behavior: Live carrier rates are merged with any configured flat-rate options and presented to the customer sorted low-to-high.
Graceful degradation: If a carrier API is unreachable at checkout time, that carrier’s rates are silently skipped. Checkout is never blocked — remaining flat-rate and other carrier options continue to display normally.

​
Tax Configuration

​
US Sales Tax & Canadian Provincial VAT

  • Configure state-by-state sales tax rates for all US states.
  • Configure provincial VAT for all Canadian provinces.
Rates are applied based on the shipping destination address entered at checkout.

​
International Country VAT

Custom VAT rates can be defined per country. Country-level VAT is charged when:
  1. The charge_vat toggle is active in the Shipping & Taxes Console.
  2. The order’s destination country matches a configured VAT rate.

​
Merchant-Location-Aware VAT Engine

When the configured Merchant Country is not US or Canada, Site Store Pro activates VAT-inclusive pricing mode.

​
How It Works

All storefront prices are displayed including VAT for domestic visitors. Cross-border US/CA buyers see the net price with VAT stripped at checkout. UK merchant example:
When you change the Merchant Country to a non-US/CA country, a warning is displayed in the admin confirming that VAT-inclusive pricing mode will activate.

​
Dynamic Tax Labels

The tax line label shown on invoices, cart, and checkout adapts based on the customer’s country:

​
Per-Item Taxability (charge_tax)

Tax applicability is evaluated per line item using an OR rule:
Both variant.charge_tax and all product_field.charge_tax values must be 0 for an item to be tax-exempt.

​
Tax Calculation

Sales tax (or VAT) is then applied only to taxableSubtotal.

​
Taxability Propagation Stages

The item_taxable value is locked at the time of order placement. Subsequent changes to product variant or field charge_tax settings do not retroactively alter existing orders.

​
Merchant Location & Currency Settings

Located in the Merchant Location & Currency section of /admin/ecommerce/shipping.

​
Merchant Country

Determines whether VAT-inclusive pricing mode is activated. A confirmation warning is displayed when selecting any non-US/CA country.

​
Currency Settings

The currency symbol defaults to $. It propagates throughout the entire storefront:

Shop Catalog

Product Details

Cart

Slide-Out Cart Drawer

Order Review

Checkout Success

Order Confirmation Email

​
Order-Level Handling Charges

Handling surcharges can be configured to trigger automatically based on combinations of: When all active trigger conditions are satisfied simultaneously, the surcharge is added to the order total.