---
title: Settings - E-commerce
related:
- https://docs.kentico.com/13/e-commerce-features.md
- https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores.md
---
> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).
You can configure the Xperience E-commerce Solution settings that determine the behavior of your on-line store in the **Store configuration**, **Multistore configuration** and **Settings** applications.
> **Tip:** To find out the purpose and the specifics of the mentioned applications and generally the difference between store and multistore configuration, see [Choosing site or global e-commerce configuration](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/choosing-site-or-global-e-commerce-configuration.md).
## General settings
The general settings are located in:
- **Store configuration -> Store settings -> General**
- **Multistore configuration -> Store settings -> General**
- **Settings -> E-commerce**
| Currencies | |
| ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Main currency | Specifies the currency used for expressing prices. Learn more about currencies in [Configuring currencies](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-currencies.md).
**Restrictions:** Only users with the Global administrator privilege level can change this setting. The setting is not available in the **Settings** application. |
| Products UI | |
| Display tree of product sections | Specifies whether the system displays the tree of product sections in the **Products** application. If the sections tree is hidden, you can create only [stand-alone SKUs](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/managing-stand-alone-skus.md). Otherwise, you can create a complete product, i.e. an SKU with its page representation in the sections tree. Learn more about the product tree in [Configuring product structure](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-products/configuring-product-structure.md). |
| Products starting path | Specifies a path within the content tree of pages where the subtree of product sections starts, e.g.: _/Products_. The system displays this subtree in the administration interface when maintaining or selecting products. Learn more about product structure in [Configuring product structure](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-products/configuring-product-structure.md).
**Restrictions:** The setting has no effect if the section tree is hidden (when the **Display tree of product sections** field is cleared). |
| Display products in sections tree | Specifies if the system displays products in the product sections tree. Learn more about product structure in [Configuring product structure](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-products/configuring-product-structure.md).
**Restrictions:** The setting has no effect if the section tree is hidden (when the **Display tree of product sections** field is cleared). |
| Allow stand-alone SKUs | Indicates whether the users can create stand-alone SKUs (i.e. SKUs without their page representations). If so, the system displays the stand-alone SKUs node above the product section tree in the administration interface. Learn more about stand-alone SKUs in [Managing stand-alone SKUs](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/managing-stand-alone-skus.md) and [Configuring products](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-products.md).
**Restrictions:** The setting has no effect if the section tree is hidden (when the **Display tree of product sections** field is cleared). |
| Products properties | |
| Related products relationship name | Specifies the name of the relationship used when defining related products. If you leave the default option, i.e. _(all)_, the users can select from all relationships existing on the current site while adding related products. This gives them the possibility to use more than one type of relationship among products. Learn more about product relationships in [Working with page relationships](https://docs.kentico.com/13/managing-website-content/working-with-pages/working-with-page-relationships.md). Learn more about setting up products in [Configuring products](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-products.md). |
| Products are 'new' for | Specifies the number of days for which recently added products are considered as new products in your on-line store. The system counts the days based on the products' **In store from** property. Learn more about products in [Configuring products](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-products.md). |
| Public status for 'new products' | Specifies a product [public status](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/product-statuses.md) that the system automatically assigns to new products. Type the **Code name** value of the given public status.
Products are marked with the given status based on the **Products are ‘new’ for** setting and the **In store from** property of individual products. If you enter a value for this setting, the system automatically assigns this public status to the product status indicator of new products regardless of the product-specific public status configuration. Learn more about products in [Configuring products](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-products.md). |
| Default product image URL | Specifies the default product image URL (virtual path). The system uses this image if no image is specified for a given product. Learn more about the default product image in [Configuring products](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-products.md).**Tip:** It is recommended to enter the default product image.
If you do not enter any default product image URL, products in product listings could be displayed incorrectly. |
| Keep the advertised price of the products according to their cheapest product variant | If selected and a product's [variant](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/working-with-product-variants.md) has a lower price than the product itself, the system assigns the variant's price to the product. Therefore, the lower price is displayed on the product's detail page on the live site. Learn more about the setting in [Configuring products](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-products.md).
**Restrictions:** The setting does not apply for products under [workflow](https://docs.kentico.com/13/configuring-xperience/configuring-the-environment-for-content-editors/configuring-workflows.md). Changing the setting does not affect already existing products (you need to resave all of the existing products). |
| Taxes | |
| Default country | Specifies the default country (typically, select your country or the country where you sell the most). The system applies all taxes based on their values as set for the default country, unless the customer specifies a different country (or state) during the checkout process. Learn more about taxes in [Configuring taxes](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-taxes.md). |
| Apply taxes based on | Specifies whether the system applies taxes based on the shipping address or the billing address. Taxes related to orders with no shipping address specified are calculated based on the billing address regardless of this setting. Learn more about taxes in [Configuring taxes](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-taxes.md). |
| Prices include tax | Determines how the system handles [taxes](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-taxes.md) for the prices of [products](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products.md), [product options](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/working-with-product-options.md) and [variants](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/working-with-product-variants.md), [shipping costs](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-shipping-options.md), etc.
If disabled, store managers enter prices without tax. The system calculates and adds the tax to the price total during the checkout process.
if enabled, store managers enter prices with tax already included. The system does not change prices when calculating taxes, only shows the tax portion of the price.
In both cases, prices appear in product catalogs on the live site based on the entered price value (with or without taxes).
**Notes**:
Changing the setting value does not automatically recalculate existing product prices and orders.
If your instance runs multiple stores (e-commerce sites), the global value of this setting _**must be the same**_ as the site value for all sites that offer both [site and global products](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/choosing-site-or-global-e-commerce-configuration.md). Other scenarios are not supported, for example having a single store display prices with tax for site-specific products and without tax for global products. |
| Shopping cart | |
| Mark shopping cart as abandoned after (hours) | Specifies after how many hours the system marks customers' shopping carts as abandoned. This setting is then used by a scheduled task that uses the _CMS.Ecommerce.MarkCartAbandoned_ class, which you can use for a marketing automation process that sends your customers a reminder that they left your website with their shopping cart with products in it. See more information about this process in [Walkthrough - Sending an automated reminder of an abandoned shopping cart](https://docs.kentico.com/13/on-line-marketing-features/configuring-and-customizing-your-on-line-marketing-features/configuring-marketing-automation/walkthrough-sending-an-automated-reminder-of-an-abandoned-shopping-cart.md). |
| Clear content of old shopping cart after (days) | Specifies after how many days the system selects shopping carts stored in the database to be removed. This setting is then used by a scheduled task that uses the _CMS.Ecommerce.ShoppingCartCleaner_ class, which you can use for automatic removing of shopping carts stored in the database. See more information about this process in [Deleting expired shopping carts from the database](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/deleting-expired-shopping-carts-from-the-database.md). |
| Rounding options | |
| Price rounding | Specifies how the system rounds numbers for price values when calculating taxes or discounts, converting currencies, etc.
The number of decimal places where rounding is applied depends on the [configuration of individual currencies](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-currencies.md).
You can choose between the following types of rounding:
**Mathematical** – standard rounding to the nearest number, with midpoint values rounded up (toward the nearest number that is away from zero).
**Truncate** – all values are rounded down (decimal numbers beyond the allowed limit are discarded).
**Financial** – standard rounding to the nearest number, with midpoint values rounded toward the nearest even number.
For example, the following table shows how the rounding types work for values in a currency that uses 2 decimal places:| Original number | Mathematical | Truncate | Financial |
| --------------- | ------------ | -------- | --------- |
| 5.125 | 5.13 | 5.12 | 5.12 |
| 120.555 | 120.56 | 120.55 | 120.56 |
| 9.989 | 9.99 | 9.98 | 9.99 | |
| Unregistered customers | |
| Register customer after first checkout | Specifies if the system automatically creates an account for unregistered customers after making their first order. The system uses data that the customer provided during the checkout process. The customer then receives a notification email with their login information, i.e. an email address and a randomly generated password. Learn more about automatic registering after the checkout process in [Enabling automatic registration for anonymous customers](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/enabling-automatic-registration-for-anonymous-customers.md). |
| Registration after checkout email template | Specifies the email template the system uses to notify customers that they were registered after their first order (if the **Register customer after first checkout** setting is enabled). Learn more about email notifications in [Configuring e-commerce email notifications](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-e-commerce-email-notifications.md). |
| Invoice | |
| Invoice number pattern | Specifies the pattern used for generating invoice numbers. If left empty, the default pattern _{% Order.OrderID %}_ is used; invoice numbers are then equal to order IDs. Learn more about invoices in [Configuring invoices](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-invoices.md). |
| Measurement units | |
| Mass unit | Specifies the unit of weight of products. When a store administrator types weight of a product, the weight is of this unit. The unit is then used, for example, for shipping calculation. Learn more about products' weight in [Configuring products](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-products.md).
**Restrictions:** This setting is **only global** and applies for all your sites. Therefore, these settings are available only in the **Multistore configuration** application and the **Settings** application when _(global)_ is selected in the **Site** drop-down list. |
| Mass format string | Specifies the format string used for displaying product weight. The _{0}_ specifier represents the weight number, e.g., if the weight should be displayed as _30 kg_, type _{0} kg_ to this field. The appearance can vary for different [cultures](https://docs.kentico.com/13/multilingual-websites/setting-up-multilingual-websites.md).
Example
The example weight is _20.5 lb_.| Typed format string | Cultures using point as decimal mark | Cultures using comma as decimal mark | Notes |
| ------------------- | ------------------------------------ | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| {0} lb | 20.5 lb | 20,5 lb | Displays as many decimal places as the number has. |
| {0:F0} lb | 20 lb | 20 lb | _F0_ displays 0 decimal places without rounding. |
| {0:F4} lb | 20.5000 lb | 20,5000 lb | _F4_ displays 4 decimal places. |
| {0:000.000} lb | 020.500 lb | 020,500 lb | Instead of the _F_-notation, you can use 0-based notation. _000.000_ displays at least three numbers before decimal mark and always three numbers after decimal mark. |
For complete information about format strings, see the [Standard numeric format strings](https://docs.microsoft.com/en-us/dotnet/standard/base-types/standard-numeric-format-strings) article.
If you want to apply the format string to a value, use the [GetFormattedWeight() macro method](https://docs.kentico.com/13/macro-expressions/reference-macro-methods.md). |
| Pages | |
| Wishlist URL | Specifies the URL of the site's _wishlist_ page. Enter the value as a relative virtual path, for example: _\~/Wishlist_
Within email templates and invoices, you can retrieve the matching live URL for a specific site using the **WishlistAbsoluteUrl** macro method. For example:
_{% WishlistAbsoluteUrl(CurrentSite.SiteName) %}_ |
| Shopping cart URL | Specifies the URL of the site's [shopping cart page](https://docs.kentico.com/13/e-commerce-features/developing-on-line-stores/implementing-a-checkout-process/integrating-the-shopping-cart.md). Enter the value as a relative virtual path, for example: _\~/Checkout_
Within email templates and invoices, you can retrieve the matching live URL for a specific site using the **ShoppingCartAbsoluteUrl** macro method. For example:
_{% ShoppingCartAbsoluteUrl(CurrentSite.SiteName) %}_ |
| Redirect to shopping cart | If enabled, users are redirected to the shopping cart page after adding a product to the cart. |
## Email settings
The email settings are located in:
- **Store configuration -> Store settings -> Emails**
- **Multistore configuration -> Store settings -> Emails**
- **Settings -> E-commerce** (under [the general settings](#general-settings))
| Emails | |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Send e-commerce emails from | Specifies an email address from which e-commerce notification emails are sent. Learn more about email notifications in [Configuring e-commerce email notifications](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-e-commerce-email-notifications.md). |
| Send e-commerce emails to | Specifies email addresses to which administration e-commerce notification emails are sent (separated by semicolons). Typically, it is the merchant's email address. Learn more about email notifications in [Configuring e-commerce email notifications](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-e-commerce-email-notifications.md). |
| Send order notification | Specifies if the system sends email notifications after completing and saving [orders](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/orders.md).
The _E-commerce - Order notification to customer_ [email template](https://docs.kentico.com/13/configuring-xperience/managing-email-templates.md) is used when sending notifications to [customers](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/customers.md). The _E-commerce - Order notification to administrator_email template is used when sending notifications to administrators. Learn more about email notifications in [Configuring e-commerce email notifications](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-e-commerce-email-notifications.md). |
| Send payment notification | Specifies if the system sends email notifications after customers complete order [payment](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-payment-methods.md). The system sends these notifications automatically if the customers paid through payment gateways, or if orders moved to a status with the [Mark order as paid](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/orders/order-statuses.md) property enabled. Store administrators can also manually complete order payment by enabling **Order is paid** for selected orders.
The _E-commerce - Order payment notification to customer_ email template is used when sending notifications to customers. The _E-commerce - Order payment notification to administrator_ email template is used when sending notifications to administrators. Learn more about email notifications in [Configuring e-commerce email notifications](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-e-commerce-email-notifications.md). |
| Send e-products reminder (days) | Specifies how many days prior to e-products expiration the system sends a notification email to the customers.
The _E-commerce - E-product expiration notification_ email template is used. Learn more about email notifications in [Configuring e-commerce email notifications](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-e-commerce-email-notifications.md). |
| Use customer's culture for emails | Specifies if the system sends the customers' emails in the customers' shopping cart culture. Learn more about email notifications in [Configuring e-commerce email notifications](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-e-commerce-email-notifications.md). |
## Global object settings
The global object settings are located in:
- **Store configuration -> Store settings -> Global objects**
- **Multistore configuration -> Store settings -> Global objects**
- **Settings -> E-commerce -> Global objects**
On this setting page, you can choose which global objects and settings the system uses. See the complete description of the store vs. multistore approach along with the list of objects grouped by their type in [Choosing site or global e-commerce configuration](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/choosing-site-or-global-e-commerce-configuration.md).