---
title: Lowest price over time
slug: commerce-connect-15/docs/lowest-price-over-time
docTags: 
createdAt: 2026-07-30T20:34:41.000Z
---

In Optimizely Commerce Connect, you can let users see the lowest price of products over a specified number of days on the website. Administrators can enable this feature for each market and set the time period in days, with a default of 30 days.

:::hint{type="info"}
**Note**
When you activate the feature, the lowest price counts from the day you activated it. This means Commerce Connect may not reflect the actual lowest price in the past 30 days. To apply it the first time, you should manually configure the lowest price with the APIs. After 30 days, the system will automatically display the correct lowest price.

This only applies for products you have discounted in the past 30 days.
:::

## Market settings

Go to **Settings > Markets** and select the checkbox for **Enable Lowest Price Display**.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/QbhCdqD9rJybLuiH-o9Bm_91d3665dd219fa28da1c8520e713953962a8bbbf5c3eaf6bc7b37c0b686813a6-lowest-price-market-settings.png)

## Options class

Administrators can use the options class to specify the time period, in days, for tracking the lowest price. The default is 30 days.

```csharp
[Options(ConfigurationSection = ConfigurationSectionConstants.Commerce)]
public class LowestPriceOptions
{
    public int DaysAgo { get; set; } = 30;
}
```

You can configure this setting in the `appsettings.json` file.

```json
"Commerce": {
  "LowestPriceOptions": {
    "DaysAgo": 30
  },
}
```

## APIs

Commerce Connect has an interface to manage the market settings for enabling this feature.

```csharp
public interface ILowestPriceMarket
{
    bool IsLowestPriceEnabled { get; set; }
}
```

Markets must implement this interface to use the feature, as shown in the following code sample:

```csharp
public class MarketImpl : IMarket, ILowestPriceMarket { }
```

Commerce Connect has another interface for saving, retrieving, or deleting the lowest price.

```csharp
public interface ILowestPriceService
{
    IEnumerable<ILowestPriceValue> List(IEnumerable<string> catalogEntryCodes, string siteId);
    void Save(IEnumerable<ILowestPriceValue> lowestPriceValues);
    void DeleteOldPrices(string siteId, int daysAgo);
}
```

### Get a list of lowest prices

The `List()` method retrieves the lowest prices for a list of entries using entry codes and a site ID. The following code sample demonstrates how to call this API:

```csharp
var market = _currentMarket.GetCurrentMarket();
if (market is ILowestPriceMarket lowestPriceMarket && lowestPriceMarket.IsLowestPriceEnabled)
{
    return _lowestPriceService.List(new[] { entryCode1, entryCode2, entryCode3 }, siteId);
}
```

### Save the lowest price

The `Save()` method stores the lowest price for a list of entries using entry codes. The following code sample calls this API:

```csharp
var market = _currentMarket.GetCurrentMarket();
if (market is ILowestPriceMarket lowestPriceMarket && lowestPriceMarket.IsLowestPriceEnabled)
{
    var lowestPrice1 = new LowestPriceValue
    {
        CatalogEntryCode = "Entry_1",
        AppliedDate = DateTime.UtcNow,
        MarketId = market.MarketId,
        Currency = market.DefaultCurrency,
        SiteId = "site id",
        LowestPrice = new Money(10, market.DefaultCurrency)
    };

    var lowestPrice2 = new LowestPriceValue
    {
        CatalogEntryCode = "Entry_2",
        AppliedDate = DateTime.UtcNow,
        MarketId = market.MarketId,
        Currency = market.DefaultCurrency,
        SiteId = "site id",
        LowestPrice = new Money(12, market.DefaultCurrency),
    };

    _lowestPriceService.Save(new[] { lowestPrice1, lowestPrice2 });
}
```

### Delete old lowest prices

The `DeleteOldPrices()` method removes the lowest prices for entries older than a specified number of days.

```csharp
var market = _currentMarket.GetCurrentMarket();
if (market is ILowestPriceMarket lowestPriceMarket && lowestPriceMarket.IsLowestPriceEnabled)
{
    _lowestPriceService.DeleteOldPrices(siteId, daysAgo);
}
```