Settings - E-commerce

Here you can configure the Kentico E-commerce Solution settings.

Products UI

Display tree of product sections

Indicates whether the system displays the tree of product sections in the products administration UI. If the sections tree is hidden, you can create only stand-alone SKUs from the products administration UI. Otherwise, you can create a complete product, i.e. an SKU with its page representation in the sections tree.

Products starting path

Indicates a path within the content tree where the subtree of product sections starts, e.g.: /Products. The system displays this subtree in the products administration UI. The setting has no effect if the sections tree is hidden. 

Display products in sections tree

Indicates if the system displays products in the product sections tree. The setting has no effect if the sections tree is hidden. 

Allow stand-alone SKUs

Indicates whether the users can create stand-alone SKUs (i.e. SKUs without their page representations in the sections tree). If so, the system displays the stand-alone SKUs node above the product sections tree in the products administration UI. The setting has no effect if the sections tree is hidden. 

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.

Products are ‘new’ for

Specifies the number of days for which the recently added products are marked as New products in your on-line store. The system counts the days based on the products’ In store from property.

Public status for ‘new products’

Specifies a product public status indicating that this product is new in your on-line store. The system can mark any product with this status automatically based on the Products are ‘new’ for setting, and the In store from product property, regardless of the product-specific public status configuration. The product-specific public status is then used when displaying the product status indicator on the live site.

Default product image URL

Here you can enter the default product image URL (virtual path). The system uses this image if no image is specified for a given product.

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, the system revalues the product’s price to a product variant’s price when the product variant is set with a lower price. Therefore, the lower price is displayed on the product detail page on the live site.

Note: If you change this setting, it does not affect the already existing products. For that, you need to resave all of the existing products.

If you use workflows, the setting will not be applied.

Taxes

Default country

Allows you to specify the default country, or select your country or 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 their country (or state) during the checkout process.

Apply taxes based on

Indicates whether the system applies taxes based on the shipping address or billing address. Taxes related to orders with no shipping address specified are calculated based on the billing address, regardless of this setting.

Unregistered customers

Register customer after first checkout

Indicates if the system automatically creates an account for unregistered customers after successfully completing the checkout process. 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.

Registration after checkout email template

The system sends a notification email to unregistered customers after the first checkout if the Register customer after first checkout setting is enabled. This setting allows you to select or modify a template for the notification email.

Live site pricing

Display price including discounts

Indicates if the system displays product prices on the live site including discounts. This takes effect only for prices that are displayed through the GetSKUFormattedPrice() or GetSKUPriceSaving() methods.

Display price including taxes

Indicates if the system displays product prices on the live site including taxes. This takes effect only for prices that are displayed through the GetSKUFormattedPrice() or GetSKUPriceSaving() methods.

Invoice

Invoice number pattern

Indicates 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.

Measurement units

Mass unit

Indicates the unit of weight of products and shipping options. When store administrator enters weight of a product or a shipping option, the weight is of this unit. The unit is then used, for example, for shipping calculation.

This setting is only global and applies for all your sites.

Mass format string

Indicates 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.

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:F} lb

20.50 lb

20,50 lb

F without any number is taken as F2 and displays 2 decimal places.

{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.

You can use the format string in the Shopping cart totals web part, in which you can display the total weight of the shopping cart. To use the format string in macros, use Settings.ECommerce.Units.CMSStoreWeightFormattingString.

Example

For using the format string on product detail page, use ECommerceContext.CurrentProduct.SKUWeight.Format(Settings.ECommerce.Units.CMSStoreWeightFormattingString).

Pages

My account URL

Indicates the URL of the My account page (virtual path).

Wishlist URL

Indicates the URL of the Wishlist page (virtual path).

Shopping cart URL

Indicates the URL of the Shopping cart page (virtual path).

Redirect to shopping cart

If on, the system redirects the customer to the shopping cart content page when they click Add to shopping cart. Otherwise, the customer stays on the same page, and the product is added to the shopping cart in the background.

Emails

Send e-commerce emails from

Here you can specify an email address from which e-commerce notification emails are sent.

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.

Send order notification

Indicates 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.

Send payment notification

Indicates if email notifications are sent after completing order payment. 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 property on (available in Store configuration -> Order status -> edit order status).

Besides, store administrators can manually complete order payment by turning on Order is paid for selected orders (available in Orders -> edit order -> Billing tab).

Note: The E-commerce - Order payment notification to customer email template is used when sending notifications to customers, and the E-commerce - Order payment notification to administrator email template is used when sending notifications to administrators.

Send e-products reminder (days)

Allows you to specify how many days prior to e-products expiration the system sends to the customers a notification email.

Use customer’s culture for emails

Indicates if the system sends the customers emails in the shopping cart culture.

Conversion tracking

Registration conversion name

Here you can enter the name of a conversion logged when a customer successfully registers on the site while going through the checkout process.

Registration conversion value

Allows you to specify a number that the system records, together with the Registration conversion, as the Registration conversion value when this 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 conversion.

You can insert a macro expression to dynamically retrieve a value from the current website context.

Order conversion name

Here you can enter the name of a conversion logged when a customer completes an order.

Order conversion value

Allows you to specify a number that the system records, together with the Order conversion, as the Order conversion value when this 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 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. With this configuration, each Order conversion automatically stores the given order’s price as its value.

Add to shopping cart conversion name

Here you can enter the name of a conversion logged when a customer adds a product to the shopping cart.

Add to shopping cart conversion value

Allows you to specify a number that the system records, together with the Add to shopping cart conversion, as the Add to shopping cart conversion value when this 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 conversion.

You can insert a macro expression to dynamically retrieve a value from the current website context.

For example: {% ShoppingCartItem.UnitTotalPrice %}

With this macro as the conversion value, the Add to shopping cart conversion logs the price (including tax) of a product added to the shopping cart.