Configuration

The Tax Exempt Groups service plugin is configuration-only — you declare the tax exempt groups your app provides, and Wix adds them to the site's available tax exempt groups when your app is installed. There are no methods to implement.

Follow these steps to add the service plugin:

1. Go to Extensions in your app's dashboard.

2. Click + Create Extension in the top right.

3. Find Tax Exempt Groups Provider and click + Create.

4. Use the JSON editor to create the extension's configuration file. Configure the parameters by referencing the table below or the Documentation section to the right of the editor.

   Name	Type	Description
   deploymentUri	string	Base URI of the service plugin implementation. Since no endpoint is called, it may be left blank.
   taxExemptGroups	array	The tax exempt groups your app provides. Up to 100 groups. Each entry is a tax exempt group object (see below).

   Each object in taxExemptGroups has the following fields:

   Name	Type	Description
   exemptTaxGroupName	string	Display name of the exempt group. Maximum 100 characters.
   id	string	Unique ID (GUID) for the exempt group.
   exemptRegions	object	Where the exemption applies. Contains regionScope and, for specific regions, a regions list.

   The exemptRegions object has the following fields:

   Name	Type	Description
   regionScope	string	WORLDWIDE to apply the exemption everywhere (leave regions empty), or SPECIFIC_REGIONS to apply it only to the listed regions.
   regions	array	The regions where the exemption applies, used when regionScope is SPECIFIC_REGIONS. Up to 200 regions. Each entry has a countryCode and optional subdivisions.

   Each object in regions has the following fields:

   Name	Type	Description
   countryCode	string	2-letter ISO 3166-1 alpha-2 country code, such as US.
   subdivisions	array	Optional ISO 3166-2 subdivision codes (without the country prefix), such as NY or CA. If empty, the exemption applies to the entire country. Up to 100 subdivisions.

5. Click Test Your App.

Example configuration