Tax management

Tax management in the Merchant Center handles the Tax Categories and Tax Rates applied to Products and shipping. Configure Tax Rates by country or region to ensure accurate tax calculations during checkout.

Access tax settings

1. Go to Settings > Project settings.
2. Select the Taxes tab.

The Taxes page displays a table of all configured Tax Categories with:

• Tax name
• Key (internal identifier)
• Associated countries
• Dates created and modified

View and configure Tax Categories

Each tax category groups products and shipping methods with the same tax rate rules. To view or modify a tax category:

1. On the Taxes page, click the tax category you want to configure.
2. In the General information section, update the Tax name, Key, or Description as needed.
3. In the Tax rates section, review the tax rates. Each rate shows its Name, Key, State/Province, Country, Rate (range 0-1), Tax Subrates, and Included in price values.
4. Click Save changes. To discard your changes, click Revert changes.

Add a Tax Rate

1. In the Tax rates section, click Add rate.
2. In the Add tax rate dialog, enter the following:
   • For Name, enter a name for the tax rate.
   • Optional: For Key, enter a unique identifier for the tax rate.
   • Optional: For State/Province, enter the state or province where the rate applies. Use this to add more than one rate for the same country, for example, for different US states.
   • For Country, select the country where the rate applies.
   • For Rate (range 0-1), enter the rate as a decimal value. For example, enter 0.19 for a 19% tax rate.
   • For Tax included in price, select Yes or No.
   • Optional: To add subrates, click Add subrate in the Tax Subrates section.
3. Click Add tax rate.
4. Click Save changes.

Create a Tax Category

To add a new tax category:

1. On the Taxes page, click Add tax category.
2. Enter the following information:
   • For Tax name, enter the display name for this category.
   • Optional: For Key, enter an internal identifier.
   • Optional: For Description, enter notes about the category.
3. For each country where this category applies, add a tax rate.
4. Click Create tax category.

Manage Tax Categories

The Taxes page provides tools to organize and find tax categories:

Sort Tax Categories

Click column headers to sort the table:

• Tax name (alphabetically)
• Key (alphabetically)
• Date created (newest or oldest first)
• Date modified (newest or oldest first)

Filter and search

Use pagination controls to navigate through tax categories:

• Items per page dropdown - Choose how many categories display per page (default: 20)
• Previous/Next buttons - Navigate between pages
• Page number input - Jump directly to a specific page

Delete a Tax Category

To remove a tax category:

1. On the Taxes page, click the tax category.
2. Click Delete tax category.
3. Confirm the deletion.

A Tax Category can only be deleted if it is not assigned to Products or Shipping Methods in your Project.

Add more than one rate for a country

Assign Tax Categories to Products

Products are assigned to tax categories during product creation or editing. To assign or change a tax category:

1. Select Products from the main menu.
2. Open the product you want to configure.
3. In the product details, locate the Tax category field.
4. Select the appropriate tax category from the dropdown.
5. Save your changes.

The selected tax category determines which tax rates apply to that product when customers purchase it.

Assign Tax Categories to Shipping Methods

Shipping methods also use tax categories to calculate tax on shipping costs. To assign a tax category to shipping:

1. Select Settings > Project settings > Shipping methods.
2. Open the shipping method you want to configure.
3. In the General information section, select a Tax category from the dropdown.
4. Save your changes.

The selected tax category determines the tax applied to shipping charges.