Is this really the version you are looking for? Kentico Xperience 10 Documentation is no longer updated. Use the switcher in the header to choose your product version.
You can configure the Kentico E-commerce Solution settings that determine the behavior of your on-line store in the Store configuration, Multistore configuration and Settings applications. Every one of them contains different settings, which you can configure. On this page, you can find out in which application you can configure different settings.
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.
Remember you can also use web.config settings to configure additional e-commerce settings or you can define your own web.config settings and then retrieve them in source code:
string value = CMS.Base.SettingsHelper.AppSettings["MyCustomKey"];The general settings are located at:
Currencies | |||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Main currency | Specifies the currency used for expressing prices. Learn more about currencies in Configuring currencies. Restrictions: Only global administrator 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. 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. | ||||||||||||||||||||
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. 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. 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 and Configuring products. 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 Displaying related pages using named relationships. Learn more about setting up products in Configuring products. | ||||||||||||||||||||
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. | ||||||||||||||||||||
Public status for 'new products' | Specifies a product public status 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. | ||||||||||||||||||||
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. 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 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. Restrictions: The setting does not apply for products under workflow. 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. | ||||||||||||||||||||
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. | ||||||||||||||||||||
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. | ||||||||||||||||||||
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 Removing old shopping carts from the database. | ||||||||||||||||||||
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. | ||||||||||||||||||||
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. | ||||||||||||||||||||
Live site pricing | |||||||||||||||||||||
Display price including catalog discounts | Specifies if the system displays product prices on the live site including catalog discounts. Learn more about creating product listing and product detail pages in Configuring product pages. Restrictions: This setting takes effect only for prices that are displayed through theGetSKUFormattedPrice()orGetSKUPriceSaving()transformation methods. | ||||||||||||||||||||
Display price including taxes | Specifies if the system displays product prices on the live site including taxes. Learn more about creating product listing and product detail pages in Configuring product pages. Restrictions: This setting takes effect only for prices that are displayed through theGetSKUFormattedPrice()orGetSKUPriceSaving()transformation methods. | ||||||||||||||||||||
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. | ||||||||||||||||||||
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. 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. Example The example weight is 20.5 lb.
For complete information about format strings, see MSDN (opens in a new tab). The format string is used, for example, in the Shopping cart totals web part, in which the total weight of the shopping cart is displayed. If you want to use the format string elsewhere, use theGetFormattedWeight()macro method. | ||||||||||||||||||||
Pages | |||||||||||||||||||||
My account URL | Specifies the URL of the My account page (virtual path). You can then retrieve the URL with the {% Settings.CMSMyAccountURL %} macro method. | ||||||||||||||||||||
Wishlist URL | Specifies the URL of the Wishlist page (virtual path). You can then retrieve the URL with the {% Settings.CMSWishlistURL %} macro method. | ||||||||||||||||||||
Shopping cart URL | Specifies the URL of the Shopping cart page (virtual path). You can then retrieve the URL with the {% Settings.CMSShoppingCartURL %} macro method. Learn more about displaying shopping cart preview on pages, where this macro can be especially useful, in Displaying the shopping cart preview on pages. Learn more about shopping carts in Configuring steps of the checkout process. | ||||||||||||||||||||
Redirect to shopping cart | Specifies whether the system redirects the customer to the shopping cart page when they click Add to shopping cart. If cleared, the customer stays on the same page, and the product is added to the shopping cart in the background. Learn more about shopping carts in Configuring steps of the checkout process. | ||||||||||||||||||||
The email settings are located at:
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. |
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. |
Send order notification | Specifies if the system sends email notifications after completing and saving orders. The E-commerce - Order notification to customer email template is used when sending notifications to customers. The E-commerce - Order notification to administratoremail template is used when sending notifications to administrators. Learn more about email notifications in Configuring e-commerce email notifications. |
Send payment notification | Specifies if the system sends email notifications after customers complete order payment. The system sends these notifications automatically if the customers paid through payment gateways, or if orders moved to a status with theMark order as paidproperty 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. |
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. |
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. |
The marketing settings are located at:
Conversion tracking | |
|---|---|
Order conversion name | Specifies the name of a custom conversion logged when a customer completes an order. Learn more about e-commerce custom conversions in Logging custom conversions on your website. |
Order conversion value | Specifies a number that the system records when the order custom conversion is logged. The values are cumulative, i.e. when a conversion hit is logged, the specified value is added to the total sum previously recorded for the custom conversion. You can insert a macro expression to dynamically retrieve a value from the current website context. For example: {% EcommerceContext.CurrentShoppingCart.TotalPrice %}. The macro is resolved into total price of all items contained in the order, including tax and shipping. Learn more about e-commerce custom conversions in Logging custom conversions on your website. |
Add to shopping cart conversion name | Specifies the name of a custom conversion logged when a customer adds a product to the shopping cart. Learn more about e-commerce custom conversions in Logging custom conversions on your website. |
Add to shopping cart conversion value | Specifies a number that the system records when an add-to-shopping-cart custom conversion is logged. The values are cumulative, i.e. when a conversion hit is logged, the specified value is added to the total sum previously recorded for this custom conversion. You can insert a macro expression to dynamically retrieve a value from the current website context. For example: {% ShoppingCartItem.UnitTotalPrice %}. This macro logs the added products' price (including tax). Learn more about e-commerce custom conversions in Logging custom conversions on your website. |
The global object settings are located at:
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.
The Authorize.NET settings are located at Settings -> E-commerce -> Payment gateways -> Authorize.NET. This type of settings is not available in the Store configuration or Multistore configuration application.
See more about Authorize.NET settings in Settings - Authorize.NET. Learn more about Authorize.NET payment gateway in Configuring Authorize.NET.
The PayPal settings are located at Settings -> E-commerce -> Payment gateways -> PayPal. This type of settings is not available in the Store configuration or Multistore configuration application.
See more about PayPal settings in Settings - PayPal. Learn more about Authorize.NET payment gateway in Configuring PayPal.
Example
For using the format string on product detail page, use:
Where SKUWeight is a double.
Learn more about products' weight in Configuring products.