> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Displaying new products

> How to mark newly added products in WEBSALE V8s, output them as a separate list, and sort product lists by them.

Products newly added to the assortment can be highlighted in the shop with a note on the product, a separate overview, or a sorting in product lists.

The basis is always the creation date of the product and the setting for how long a product counts as new after this date. You set up both once, after which all three display types are available.

![New products](https://mintcdn.com/websaleag-44ee7ea6/98HtpcQDYdzjmpoC/images/produkte_neu.jpg?fit=max\&auto=format\&n=98HtpcQDYdzjmpoC\&q=85\&s=1cd8ac8d3d4f588799071cb42c88ae05)

## Prerequisites

### Creation date in the product data

Specify in the product data when the product was added to the assortment.

Products without a creation date never count as new. They are therefore also missing from the overview of new products, without a message appearing.

### Defining how long "new" lasts

The `NewProductDays` parameter in the `<Basic>` section of the `shop.config` determines how many days after the creation date a product counts as new.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<Basic>
   ...
   NewProductDays = 10
   ...
</Basic>
```

The creation day counts as the first day. With the value `10` and the creation date 01.09.2026, the product counts as new up to and including 10.09.2026, and no longer from 11.09.2026.

Reference: [Basic section](https://dokumentation.websale.de/en/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/grundlagen-und-technik.md#basic)

## Marking new products

The `PR-IsNew` bracket encloses the marking, either a text, an icon, or your own formatting. It works wherever product data is available, that is, on the product detail view as well as in product lists.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{PR-IsNew}
   <span class="badge-new">Neu bei uns im Shop</span>
{/PR-IsNew}
```

Reference: [PR-IsNew](https://dokumentation.websale.de/en/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md)

### Outputting the creation date

In addition, `PR-CreationDate` outputs the creation date in the format `DD.MM.YYYY`. As a bracket, it applies as soon as a creation date is stored.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{PR-IsNew}
   Neu im Sortiment{PR-CreationDate} seit ~PR-CreationDate~{/PR-CreationDate}
{/PR-IsNew}
```

Reference: [PR-CreationDate](https://dokumentation.websale.de/en/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md)

## Overview of all new products

Via the pseudo category index `$NewProd`, you output all new products as a list anywhere in the shop. The home page `ws_start.htm` is an obvious choice.

In the following example, up to 15 new products appear.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{CAT-AdvData($NewProd,15)}
   Neu in unserem Sortiment:
   {@PR-Data}
      <a href="~PR-Link~">
         <img src="~PR-Thumbnail~" alt="~PR-Name~">
         ~PR-Name~
      </a>
      ~PR-Price~ ~WS-Currency~
   {/@PR-Data}
{/CAT-AdvData($NewProd,15)}
```

The second argument limits the number. If there are no new products, the entire area including the heading is omitted.

Reference: [CAT-AdvData()](https://dokumentation.websale.de/en/v8s/referenz/tags/cat/navigation-und-kategoriebaum.md#cat-advdata)

## Sorting by new products

Product lists of a category and search result lists can be sorted by recency. How to integrate this sorting is described on the page about sorting product lists.

Guide: [Sorting product lists](https://dokumentation.websale.de/en/v8s/funktionen-fuer-produktlisten/produktlisten-sortieren.md)


## Related topics

- [Sorting product lists](https://dokumentation.websale.de/en/v8s/funktionen-fuer-produktlisten/produktlisten-sortieren.md)
- [Displaying the selected product](https://dokumentation.websale.de/en/v8s/produkte/gewaehltes-produkt-anzeigen.md)
- [Displaying grouping products](https://dokumentation.websale.de/en/v8s/produkte/gruppierungsprodukte-anzeigen.md)
- [Displaying products on an alternative template](https://dokumentation.websale.de/en/v8s/produkte/produkte-auf-alternativem-template-anzeigen.md)
- [Displaying product properties as a list](https://dokumentation.websale.de/en/v8s/produkte/produkteigenschaften-als-liste-anzeigen.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.