# Product List

Describes a product list. This object is intended for simple carousels and listings only. For more advanced use cases, such as fetching all new, discounted, or recent products, you should use the catalog, product group, manufacturer, or search pages with appropriate filters.

## Usage Example

```liquid
{%- comment -%} Render a carousel of discounted products {%- endcomment -%}
<ul class="product-carousel">
  {% for product in product_list.discounted %}
    <li>
      <a href="{{ product.url }}">{{ product.title }}</a>
      {% if product.price < product.original_price %}
        <span class="discount">On sale!</span>
      {% endif %}
    </li>
  {% endfor %}
</ul>
```

## Properties

### discounted

List discounted products in the store. Returns 100 products at most.

### new_products

List new products in the store. Returns 100 products at most.

### recent

List recent products in the store. Returns 100 products at most.

### tags

Fetch products by tags.