Get to know our frameworks

Select an app template built on your preferred framework.

Build apps on our native app editor. Use drag and drop elements, Velo code and Wix APIs to develop custom features.

Streamline your app development process with the Wix CLI. Get a familiar developer experience with minimal setup and configuration.

Take full control over your app's tech stack, deployment, and hosting.

App templates

Wix Blocks templates

Wix CLI templates

Self-hosted templates

Kickstart your app development with templates built on your preferred Wix developer tool. Browse templates for practical foundation and get to know the Wix ecosystem.

Wix App Templates for Developers

This example apps can be used as a starting point for building your own app, for concrete examples of how to use Wix framework, or for inspiration.

Choose a template.<0 />Build an app.

Browse by:

How to build it step by step:

This template is built with:

Read how this template was built, step by step.

How we built this template

Deployment instructions:

Choose a package manager and run the command in your terminal.

Copy command

Before you get started, make sure you have the following:

Prerequisite steps

Get started with Wix CLI

Begin by setting up your Next.js project with your preferred hosting platform.

Select your hosting service

Start the deployment flow and set up your template repo on Netlify. After you finish set up, come back here and add your Netlify custom domain.

Copy the code from our Git repo to deploy your app on any platform that supports Next.js.

Start the deployment flow and set up your template repo on Vercel. After you finish set up, come back here and add your Vercel generated URL.

Add the base URL and give your app a name.

App details

Go to the app dashboard and test your app to ensure a smooth integration within the Wix ecosystem. <0>Learn more about app checks and testing</0>

Define your environment

Terminal

Related templates

Note

Warning

Your app name will be used as the namespace suffix.

Name your app to generate a namespace. This lets you refer to your app in code later on.

Go Headless

Build Apps

Client

API Preview

Ricos

Develop Websites

REST

Velo

GraphQL (Alpha)

options

Options

context

Context

Calculates tax for the provided line items.

Tax is calculated for each line item based on the [tax region](https://dev.wix.com/docs/velo/api-reference/wix-billing-v2/tax-regions) 
in `lineItems.taxRegionId` and the [tax group](https://dev.wix.com/docs/velo/api-reference/wix-billing-v2/tax-groups) in `lineItems.taxGroupId`. 

The breakdown of calculated tax returned, includes:
+ `taxSummary`: The overall total tax calculated.
+ `lineItemTaxDetails.taxBreakdown`: The tax calculated for each line item in each jurisdiction.
+ `lineItemTaxDetails.taxSummary`: The total tax calculated for each line item.

### Where to find `calculateTax()`
When you [add the Tax Calculation service plugin](https://dev.wix.com/docs/develop-websites/articles/coding-with-velo/integrations/custom-extensions-spis/custom-app-extensions-using-sp-is#step-1-create-a-new-extension-on-your-wix-site), 
a folder is automatically added to your site. Use the `.js` file in the folder to write the code to determine how to calculate tax for an order.

export const calculateTax = async (options, context) => {
  return {
      "currency": "USD",
      "taxSummary": {
          "totalAmount": "170.00",
          "totalTax": "21.00",
          "totalTaxableAmount": "170.00",
          "totalTaxIncludedInPrice": "0.00"
      },
      "lineItemTaxDetails": [{
          "_id": "00000000-0000-0000-0000-000000000001",
          "itemName": "some",
          "quantity": 1,
          "taxBreakdown": [{
              "jurisdiction": "TEXAS",
              "jurisdictionType": taxCalculationProvider.JurisdictionType.STATE,
              "nonTaxableAmount": "0.00",
              "rate": "0.20",
              "taxAmount": "15.00",
              "taxableAmount": "120.00",
              "taxType": "Sales",
              "taxName": "TX STATE TAX"
          }],
          "taxSummary": {
              "fullPrice": "120.00",
              "taxAmount": "12.00",
              "taxableAmount": "120.00"
          }
      },
      {
        "_id": "shipping",
        "itemName": "Free Shipping",
        "quantity": 1,
        "taxBreakdown": [
          {
            "jurisdiction": "",
            "nonTaxableAmount": "0",
            "rate": "0.12",
            "taxAmount": "6.00",
            "taxName": "",
            "taxType": "",
            "taxableAmount": "50"
          }
        ],
        "taxSummary": {
          "fullPrice": "50",
          "taxAmount": "6.00",
          "taxableAmount": "50.00"
        }
      }
      ]
  }
};

Example of a `calculateTax()` return value

calculateTax

TaxCalculationResponse

Retrieves the configuration of your tax calculation plugin.

Set your tax calculation configuration in the `return` of the `getConfig()` function. Wix calls this function when you publish your site. 
Changes to the configuration don't take effect until you publish your site.

### Where to find `getConfig()`
When you [add the Tax Calculation service plugin](https://dev.wix.com/docs/develop-websites/articles/coding-with-velo/integrations/custom-extensions-spis/custom-app-extensions-using-sp-is#step-1-create-a-new-extension-on-your-wix-site), 
a folder is automatically added to your site. Use the `-config.js` file in the folder to set the default configuration for your 
implementation of the service plugin.

// Place this code in the <my-plugin-name>-config.js file
// in the 'tax-calculation-provider' folder of the
// Service Plugins section on your site.

export function getConfig() {
  return {
    calculatorDisplayName: "Custom Sales Tax",
    unsupportedCountries: "IN"
  };
};

Example of a configuration file

getConfig

TaxCalculationConfigResponse

# Introduction
The Tax Calculation service plugin (formerly SPI) allows you to integrate a custom tax calculation service with Wix. 

Use the Tax Calculation service plugin together with the [Tax Groups API](https://dev.wix.com/docs/velo/api-reference/wix-billing-v2/tax-groups) and the [Tax Regions API](https://dev.wix.com/docs/velo/api-reference/wix-billing-v2/tax-regions) to customize your tax calculations. 

Learn more:
+ [Velo: Custom App Extensions Using service plugins](https://support.wix.com/en/article/velo-custom-business-app-extensions-using-spis-beta)

### To add a service plugin
1. [Add the plugin to your site](https://dev.wix.com/docs/develop-websites/articles/coding-with-velo/integrations/custom-extensions-spis/custom-app-extensions-using-sp-is#step-1-create-a-new-extension-on-your-wix-site).
2. Update the [`getConfig()`](https://dev.wix.com/docs/velo/api-reference/wix-billing-v2/service-plugins-spis/billing-tax-calculation/get-config) function in the **-config.js** file that is added to your site during step 1.
3. Update the [`calculateTax()`](https://dev.wix.com/docs/velo/api-reference/wix-billing-v2/service-plugins-spis/billing-tax-calculation/calculate-tax) function in the **.js** file that is added to your site during step 1.

### Terminology

+ **Tax Group:** A category of products that share the same tax treatment. Tax is calculated based on the tax group and the tax region associated with a line item. See the [Tax Groups API](https://dev.wix.com/docs/velo/api-reference/wix-billing-v2/tax-groups).
+ **Tax Region:** A location, defined by `country` and `subdivision` with a specific tax treatment. Tax is calculated based on the tax region and the tax group associated with a line item. See the [Tax Regions API](https://dev.wix.com/docs/velo/api-reference/wix-billing-v2/tax-regions).
+ **Tax Calculator:** An app that is used under the hood to calculate tax for a Wix site. The app calculates tax based on the tax group of the product and the tax region of the sale. Use the Tax Calculation service plugin to become a tax calculator.

velo-spi_billing-tax-calculation

Address

Main address line (usually street name and number).

addressLine

string

Free text providing more detailed address info. Usually contains apt, suite, floor.

addressLine2

city

Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format.

country

postalCode

Code for a subdivision (such as state, prefecture, or province) in [ISO 3166-2](https://www.iso.org/standard/72483.html) format.

subdivision

[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 3-letter currency code representing the currency used in the request sent from Wix. The response should be returned in the same currency.

currency

The identity that describes the identity that triggered this request.

identity

Identity

An array of languages in which the response should be returned. Languages are strings in concatenated [ISO 639-1: 2 Alpha language-code](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) and [ISO 3166-1: 2 Alpha country-code](https://en.wikipedia.org/wiki/ISO_3166-1) format, such as "en-US".

languages

A unique identifier of the request. You may print this ID to your logs to help with future debugging and easier correlation with Wix's logs.

requestId

ID of a site visitor who has not logged in to the site. Only provided if `identityType` is `ANONYMOUS_VISITOR`.

anonymousVisitorId

ID of an app. Only provided if `identityType` is `APP`.

appId

ID of a site visitor who has logged in to the site. Only provided if `identityType` is `MEMBER`.

memberId

ID of a Wix user (site owner, contributor, etc.). Only provided if `identityType` is `WIX_USER`.

wixUserId

Type of identity that triggered the request. Possible values are:
+ `UNKNOWN`
+ `ANONYMOUS_VISITOR`
+ `MEMBER`
+ `WIX_USER`
+ `APP`

identityType

LineItem

Index of the address from `addresses` to use to calculate tax for this specific line item. The index is zero-based.

addressIndex

Stock keeping unit for this line item. Learn more about [SKUs](https://www.wix.com/encyclopedia/definition/stock-keeping-unit-sku).

itemCode

itemName

price

quantity

number

Tax group ID for this line item. If not provided, the default tax group applies.

taxGroupId

taxIncludedInPrice

boolean

taxRegionId

LineItemTaxDetails

Total amount of tax calculated for all line items. Note that due to rounding, `totalTax` may not equal the sum of `lineItemTaxDetails.taxSummary.taxAmount`.

Array of each tax applied, grouped by `jurisdiction`, `jurisdictionType`, `taxName`, `taxRate`, and `taxType`.

taxBreakdown

Summary of this line item's total price and tax.

taxSummary

LineItemTaxSummary

Total price for this line item. To determine the price for each individual unit of this line item, divide by `quantity`.

fullPrice

The total amount of tax calculated for this line item.

taxAmount

taxableAmount

MultipleAddresses

destination

origin

Array of addresses. Each line item can individually reference the address to apply with `lineItems.addressIndex`.

addresses

3-letter currency code in [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#active_codes) format.

lineItems

TaxBreakdown

Jurisdiction that taxes were calculated for.

jurisdiction

Type of jurisdiction that taxes were calculated for. For example, `"State"`, `"Çounty"`, `"City"`, `"Special"`, etc.  
Supported values: `"CITY"`, `"COUNTRY"`, `"COUNTY"`, `"SPECIAL"`, `"STATE"`, `"UNDEFINED"`

jurisdictionType

nonTaxableAmount

Tax rate used for this jurisdiction, as a decimal. For example, 10% tax is `"0.1000"` and 200% tax is `"2.0000"`.

rate

Amount of this tax calculated for this jurisdiction.

Name of the tax that was calculated. For example, `"NY State Sales Tax"`, `"Quebec GST"`, etc.

taxName

Type of tax that was calculated. For example, `"Sales Tax"`, `"Income Tax"`, `"Value Added Tax"`, etc.

taxType

calculatorDisplayName

List of countries, in [ISO-3166 alpha-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#officially_assigned_code_elements) format, that the calculator does not support.

unsupportedCountries

3-letter currency code in [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#active_codes) format. If this code doesn't match the `currency` passed in the request, then the response is invalid.

Details of each tax applied to each line item.

lineItemTaxDetails

TaxSummary

totalAmount

totalTax

Total amount of `totalTax` that is included in price. Applies to line items with `taxIncludedInPrice` set to `true`.

totalTaxIncludedInPrice

totalTaxableAmount

Multiple addresses to use for a sale. For example, some tax calculations may require both the address where an item is shipped from, as well as the address the item is shipped to.

multipleAddresses

Single address to use for a sale location when only one address is required for tax calculations. The index is zero-based.

calculateTax( )

Where to find calculateTax()

Where to find `calculateTax()`