# Project Settings

Set up essential project settings like Tax Rates, Shipping Methods, Stores, Languages, Currencies, and more.

Only users in Teams with appropriate [permissions](/merchant-center/user-permissions.md#project-settings) can view and edit project settings. The permissions are managed by the Administrators Team in your Organization.

## Manage internationalization

To configure essential settings for selling your products in different countries and regions, go to **Settings > Project settings**.

- For **Currencies**, select the currencies for the countries where your products are sold. They will be available when assigning Prices to Products or when creating Discounts.

- For **Languages**, select the languages used to localize Product information and other project-specific data.

  The selected languages are used, in their configured order, as a fallback for required localized Product data when no value exists for a projected locale.

  Modifying available languages does not affect the display language of the Merchant Center interface (for example, menu items and button text). To view or modify the interface language, click your user profile and go to **My Profile** > **Personal Settings** > **Language and region**.

- For **Countries**, the countries where you sell your products in. They will be available when configuring Shipping Methods, taxes, or Channels.

- For **Zones**, define groups of countries (Zones) to set up delivery costs for different geographic locations.

  To add a Zone, click **Add zone**, select the countries, and save the changes.

  To configure Zones for states or sub-country units, use the [Zones](/api/projects/zones.md).

## Add a Tax Category

A Tax Category groups Tax Rates together, where each Tax Rate defines the tax percentage for a specific country or state. Tax Rates can include subrates for compound taxes (for example, local, state, and federal taxes). For the complete type definitions, see the [Tax Categories API reference](/api/projects/taxCategories.md).

To create taxes, do the following:

1. Go to **Settings > Project settings** and click the **Taxes** tab.

2. Click **Add tax category**.

3. Enter the basic details for the Tax Category.

   - For **Tax name**, enter the name for the Tax Category.
   - Optional: For **Key**, enter a unique identifier value for the Tax Category.
   - Optional: For **Description**, enter a description for the Tax Category.

4. In the **Tax rates** section, click **Add rate** and do the following:

   - For **Name**, enter the name for the Tax Rate.
   - Optional: For **Key**, enter a unique identifier value for the Tax Rate.
   - Optional: For **State/Province**, enter the state or province for which the Tax Rate applies.
   - For **Country**, select the country for which the Tax Rate applies.
   - For **Rate**, enter the percentage (in decimal format) of the Tax Rate.
   - For **Tax included in price**, choose whether the tax should be included in the price.

5. Optional: To add subrates, click **Add subrate** and do the following:

   - For **Name**, enter the name for the subrate.
   - For **Rate**, enter the percentage (in decimal format) of the subrate.

   The total of all subrates must be equal to the Tax Rate.

6. Click **Add tax rate**.

7. Click **Create tax category**.

## Add a Shipping Method

Shipping Methods represent fulfillment options such as standard delivery, express delivery, or in-store pickup. Shipping rates are the prices defined per Zone and currency for a Shipping Method, and they can be fixed or tiered.

- If a shipping rate is fixed, the base shipping cost is the same for all Carts that use that Shipping Method, unless a free shipping threshold (`freeAbove`) makes shipping free.
- If a shipping rate is tiered, the shipping cost changes based on a few factors: for example, the shipping cost decreases if the Cart value increases.

For the reference definition of Shipping Methods, shipping rates, multiple Shipping Methods, and predicates, see [Shipping and Delivery Overview](/api/shipping-delivery-overview.md).

You must configure at least one Zone before configuring Shipping Methods.

To add Shipping Methods, do the following:

1. Go to **Settings > Project settings** and click the **Shipping methods** tab.

2. Click **Add shipping method**.

3. Enter the basic information for the Shipping Method.
   - For **Shipping method name**, enter localized names for the Shipping Method.
   - Optional: For **Description**, enter localized descriptions for the Shipping Method.
   - For **Tax category**, select the Tax Category ([configured](/merchant-center/project-settings.md#add-a-tax-category) for the Project).
   - Optional: For **Key**, enter a unique identifier value for the Shipping Method.
   - Optional: For **Predicate**, enter a condition for when the Shipping Method should apply to a Cart. For more information about predicates and their syntax, see [Predicates](/api/predicates/predicate-operators.md).
   - Optional: If present, select a Custom Field and enter a value for it.

     Custom Fields are defined using the [Custom Fields API](/api/projects/custom-fields.md).

4. Click **Add zone**.

5. Select a Zone (configured for the Project) and do the following:
   - For fixed shipping rates, click **Add currency-specific rates**, select the currency (configured for the Project) and enter the shipping rates. Optionally, for **Free above**, enter a Cart value threshold above which shipping is free.
     By default, Shipping Methods use fixed shipping rates. To change, see [Configure the shipping rate](/merchant-center/project-settings.md#configure-the-shipping-rate)
   - For tiered shipping rates, do the following:
     - For Cart Value shipping rates, select the currency (configured for the Project), enter the cart value and the shipping rate (for carts exceeding the defined value).
     - For Cart Classification shipping rates, select the currency (configured for the Project), select the key, and enter the shipping rate.
     - For Cart Score shipping rates, select the currency (configured for the Project), enter the score, choose if it's a fixed value or function, and enter the shipping rate.

6. Click **Create shipping method**.

## Add an Interval

Only users in Teams with appropriate [Recurrence Policies permissions](/merchant-center/user-permissions.md#recurrence-policies) can view and manage intervals. Permissions are managed by the Administrators Team in your Organization.

Intervals define how often Orders generated by Recurring Orders are created. You can create intervals with different units (for example, days, weeks, months) and values (for example, every `2` weeks).

1. Go to **Settings** > **Project settings**, then click the **Intervals** tab.
2. Click **Add Interval**.
3. In the **Add Interval** window, enter the basic information for the interval:
   - Optional: For **Name**, enter a descriptive name.
   - For **Key**, enter a unique identifier value.
   - For **Type**, select one of the following:
     - **Standard interval**: To create Orders at regular intervals (for example, every 2 weeks).
     - **Day of month**: To create Orders on a specific day of the month (for example, on the 15th of every month).
4. Enter your preferred interval settings, then click **Create interval**.

You can also update an existing interval, however, these changes will affect all current Recurring Orders that use it. This can cause unintended consequences, such as changing the next order dates.

## Add a Channel

Channels can be used to model warehouses or stores. They link entities (such as inventory or price) to a specific source, like a warehouse or a physical retail location—for example, inventory can be connected to a supply channel that would describe from which supplier a stock comes from.

1. Go to **Settings > Project settings** and click the **Channels** tab.

2. Click **Add channel**.

3. Enter the basic information for the Channel.

   - For **Channel key**, enter a unique identifier value for the Channel.
   - Optional: For **Channel name**, enter localized names for the Channel.
   - Optional: For **Channel description**, enter localized descriptions for the Channel.
   - For **Channel roles**, select the roles for the Channel. It defines the purpose of the Channel.

4. Optional: For **Geolocation**, enable the toggle and enter the geographic coordinates of the physical location of the Channel.

5. Optional: For **Address**, enable the toggle and enter the address details.

6. If present, select a Custom Field for the Channel and enter a value for it.

   Custom Fields are defined using the [Custom Fields API](/api/projects/custom-fields.md).

7. Click **Save**.

### Configure the shipping rate

By default, a fixed shipping rate applies to orders. To change the configuration, do the following:

1. Go to **Settings > Project settings** and click the **Shipping methods** tab.
2. In **Shipping rate control**, click **Fixed shipping rates only**.
3. Click the toggle and select the input type for tiered shipping rates.
4. If you selected **Cart Classification**, enter a unique identifier key value. It allows you to categorize shipping rates for unique key values.
5. Click **Confirm**.

For the reference behavior of fixed and tiered shipping rates, see [Shipping and Delivery Overview](/api/shipping-delivery-overview.md#shipping-rates).

## Add a Store

Stores can be used to model physical retail locations, brand stores, or country-specific stores, allowing you to limit access to a subset of resources within a Project. These Stores can include Carts, Orders, Shopping Lists, Customers, Business Units, Quotes, Quote Requests, Staged Quotes, Shipping Methods, Cart Discounts, and Products specific to them.

1. Go to **Settings > Project settings** and click the **Stores** tab.

2. Click **Add store**.

3. Enter the basic information for the Store.

   - For **Store key**, enter a unique identifier value for the Store.
   - Optional: For **Store name**, enter localized names for the Store.

4. Configure the settings for the Store.

   - Optional: For **Inventory supply channels**, select the (supply) Channels. They determine the inventory availability for the Store.

   Product data sent to the storefront will only include inventory entries linked to the selected (supply) Channels, as well as inventory entries not linked to any Channel. Line items in Carts and Orders, associated with the Store, are filtered the same way.

   - Optional: For **Product distribution channels**, select the (distribution) Channels. They determine the Embedded and Standalone Prices availability for the Store.

   Product data sent to the storefront will only include prices linked to the selected (distribution) Channels, as well as prices not linked to any Channel. Line items in Carts and Orders, associated with the Store, are filtered the same way.

   - Optional: For **Country(ies)**, select the countries. They determine the Embedded and Standalone Prices availability for the Store.

   Product data sent to the storefront will only include prices linked to the selected countries, as well as prices not linked to any country. Line items in Carts and Orders, associated with the Store, are filtered the same way.

   - Optional: For **Languages**, select the languages ([configured](/merchant-center/project-settings.md#manage-internationalization) for the Project).

   Product data sent to the storefront will only include localized data linked to the selected languages, impacting Product details, search results, and Cart Line Items.

   - Optional: For **Product Selections**, select the Products Selections. They determine the product catalog available for the Store.

   Product data sent to the storefront will only include active Product Selections.

5. Click **Create Store**.

### Search for Stores

Use the search box to find Stores by their name, key, or both. The search is case-insensitive and returns partial matches.

To search for Stores, do the following:

1. Go to **Settings > Project settings** and click the **Stores** tab.

2. In the search drop-down menu, select a search criterion:
   - **Store Key**
   - **Store Name**
   - **Store Name/Key** (searches both the Store key and localized Store name)

3. In the search box, enter the value to search for.

### Save and manage Store searches as a View

You can save a filtered list of Stores as a View to access it again without re-applying the same filters.

#### Create a View

1. (Optional) Adjust the data you want to see: pick a search criterion, enter a search value (if any), or show or hide columns using **Table settings** > **Column Manager**.
2. Click the **My Views** drop-down menu, which initially shows **Default**, and select **Save as new view**.
3. Enter a unique **Name** and click **Save**.

#### Manage Views

When you modify a saved View, a yellow dot appears to indicate unsaved changes. To manage your Views, select a saved View from the View menu and choose one of the following actions:

- **Update**: To save changes to a View, select **Update view**.
- **Revert**: To discard the last change, select **Revert view**.
- **Rename**: To rename a View, select **Rename view**, enter the new name, and click **Save**.
- **Delete**: To permanently remove a View, select **Delete view** and confirm the deletion.

To return to the original unfiltered table and default column arrangement, open the View menu and click **Default**.

## Miscellaneous

You can configure the following under the **Miscellaneous** tab:

- **Recommended categories**: enables [Category](/merchant-center/categories.md) suggestions for Products during creation or editing. You can choose from the following recommendation criteria:
  - **Attribute**: suggests Categories containing Products with matching Attribute names.
  - **Product type**: suggests Categories containing Products of the same Product Type.

- **Rich text editor for product descriptions**: provides advanced text formatting options to apply for your Product descriptions.
  If activated, any applied styling is converted into HTML code that your storefront can retrieve.

- **Reduce page size in “Review modified products” view**: provides a way to load limited data in the [Review modified products](/merchant-center/products.md#review-modified-products) page to improve performance and reduce loading time. If activated, the reduced page sizes can be selected instead of the default sizes.
  - **Default:** 20, 50, 100 Products per page
  - **Reduced:** 5, 10, 15, 20 Products per page

- **Order states visibility**: controls the visibility of the following Order state menus in the Merchant Center:

  - **Hide payment state dropdown**
  - **Hide shipment state dropdown**
  - **Hide order state dropdown**

    If your customer service representatives use the Merchant Center to manage orders manually (including updating these states), ensure these checkboxes are not selected so that the drop-down menus remain visible. By default, these checkboxes may be selected (hidden), as indicated in the UI.

- **URL rewrite for external images**: allows to display external Product images in the Merchant Center according to the naming format of the image hosting service.
  By default, Merchant Center does not show Product images hosted on external servers.
  You can configure the following:
  - **Size: thumb**: URL rewrite (search and replace) rules for thumbnail images.
  - **Size: small**: URL rewrite (search and replace) rules for small images.

- **Promotion Prioritization**: configures how Product Discounts and Cart Discounts interact when applied to a Cart. You can choose whether both types of discounts are combined (stacked) or only the best deal is applied to the Cart total. This setting is managed in the Project's discount configuration and impacts how discounts are calculated for your customers.

## Related pages

- [Area overview page with navigation](/merchant-center.md)
- [Next page: Developer settings](/merchant-center/developer-settings.md)
- [Search documentation and API specs](/search.md)