---
title: E-commerce web.config settings
related:
  - https://docs.kentico.com/k81/e-commerce-features/configuring-and-managing-your-store/e-commerce-website-settings.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 modify your on-line store behavior and functionality by adding and configuring keys in your project's _web.config_ file.

## Configuring E-commerce Solution web.config settings

You can configure E-commerce Solution keys in the _**appSettings**_ section of the **web.config** file (located in the root of the website):

```csharp

<configuration>
  <appSettings>
    <add key="CMSEnableOrderItemEditing" value="true" />
    .
    .
    .
  </appSettings>
</configuration>

```

The system offers the following E-commerce Solution keys:

| **Key**                             | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **CMSEnableOrderItemEditing**       | If set to **true** and the order is not  [marked as paid](https://docs.kentico.com/k81/e-commerce-features/configuring-and-managing-your-store/orders.md#marking-orders-as-paid), you can **Edit** () order item price, name and quantity. The default value is **false**.<br>![Editing order item properties](https://docs.kentico.com/docsassets/k81/e-commerce-web-config-settings/editing_order_item_properties.png "Editing order item properties")                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| **CMSUseMetaFileForProductImage**   | If set to **true** (default value), the system asks the [user](https://docs.kentico.com/k81/managing-users/user-management.md), while creating or editing a [product](https://docs.kentico.com/k81/e-commerce-features/configuring-and-managing-your-store/products.md) ([product option](https://docs.kentico.com/k81/e-commerce-features/configuring-and-managing-your-store/products/working-with-product-options.md)), to select a product image from the file system on their computer. The system then uploads the product image to a server, and saves it as a product metafile (a product image page of the **cms.file** type is not created). The path to this metafile is saved as the product image path (_SKUImagePath_).<br>If set to **false**, the system asks the user to select a page of the **cms.file** type as a product image. The path to the selected page is saved as the product image path (_SKUImagePath_). |
| **CMSShoppingCartExpirationPeriod** | Specifies the number of days after which the shopping cart is considered expired. The **Deleting old shopping carts** [scheduled task](https://docs.kentico.com/k81/configuring-kentico/scheduling-tasks.md) removes the shopping cart from the system.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

## Configuring your custom web.config settings

You can add your custom settings (keys and their values) into the _appSettings_ section of the **web.config** file (located in the root of the website).

> **Tip:** Use the **AppSettings** property of the **CMS.Base.SettingsHelper** class to work with your custom settings.

### Example

The example shows how you can get the value of the _**MyCustomKey**_ key.

```csharp

string value = CMS.Base.SettingsHelper.AppSettings ["MyCustomKey"];

```