About the Tax Settings API

The Tax Settings API manages a site's global tax configurations. With the Tax Settings API, you can:

• Read the site's current tax settings.
• Update the tax settings to control how tax is applied at checkout.

Tax-inclusive vs. tax-exclusive pricing

The taxIncludedInItemPrices field controls how checkout calculates tax:

• true: Catalog prices are treated as tax-inclusive. Checkout doesn't add additional tax on top.
• false: Catalog prices are treated as tax-exclusive. Tax is calculated and added on top of catalog prices at checkout.

If the site's tax settings have never been set, taxIncludedInItemPrices defaults to false.

Shared setting

Tax settings are shared across all Wix products on the site. Changing taxIncludedInItemPrices affects how every integrated product handles tax at checkout. For example, if a site uses both Wix Stores and Wix Bookings, updating this setting changes tax behavior for both.

Use cases

• Display prices correctly based on tax settings
• Update tax settings when a merchant configures their pricing