# How product feeds work

> What a product feed is, how scope, algorithm, secondary ranking and rules combine to pick products, and where feeds are used.

A product feed is a saved product-selection recipe. You define it once under **Data Platform › Product Feeds** and reuse it in Product Blocks on your site, in emails, push notifications, Viber and WhatsApp messages, webhooks, ads and search. When a feed changes, every element that uses it changes with it.

## What a feed is made of

| Part                                 | What it does                                                                                                                                                       |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Scope**                            | Where the feed can be used: **Web**, **Marketing Channels** or **Ads**. Fixed after the first save.                                                                |
| **Algorithm**                        | How products are ranked, for example **Popular Products** or **Trending Products (Recently Popular)**. **None** means the boosts and filters alone decide.         |
| **Secondary ranking**                | The order used when the algorithm and the boost and bury rules do not have enough data: **Most added to cart** (default), **Most viewed**, **Newest** or **None**. |
| **Rules** (**Boosts & Filters** tab) | One row per product property. Each row is **off**, **boost**, **bury**, **include** or **exclude**.                                                                |
| **Tags**                             | Optional labels for your own bookkeeping.                                                                                                                          |

## Scope

* **Web** feeds are for Product Blocks and other on-site elements. Only **Web** feeds can read the **page context** (the product or category the visitor is looking at), and only they offer the context algorithms such as **Viewed This Viewed That**, **Viewed This Bought That** and **Bought This Bought That**.
* **Marketing Channels** feeds are for emails, push, Viber, WhatsApp and webhooks. The help text in the form says it: “You can use feeds meant for marketing channels on the web but not vice-verca.” These feeds also offer **Products from latest event**, **Products from trigger event** and the last-search algorithms.
* **Ads** feeds feed ad product sets. They offer only non-personalized algorithms (popular, trending, hot, gateway) and no **user’s favorite** value source.

## Rules: boost, bury, include, exclude

The **Filters description** box on the **Boosts & Filters** tab defines the modes:

* **Boost** - Show more products that fit the criteria. Weight can be adjusted.
* **Bury** - Show fewer products that fit the criteria. Weight can be adjusted.
* **Include** - Show only products from this filter.
* **Exclude** - Don’t show products from this filter.

**boost** and **bury** have a **weight** from 1 to 10. **include** and **exclude** are hard filters. Changing a row’s mode clears the values you entered for it.

### Default rows

| Row                             | Product property                    | Default                              |
| ------------------------------- | ----------------------------------- | ------------------------------------ |
| **Price**                       | list price                          | **include**, **manual**, from `0.01` |
| **Discount %**                  | discount percentage                 | off                                  |
| **Exact Category**              | category                            | off                                  |
| **Exact and Parent Categories** | category and its parents            | off                                  |
| **Available Only**              | availability (no value to set)      | **include**                          |
| **Locale**                      | locale                              | off                                  |
| **Currency**                    | currency                            | off                                  |
| **Specific Product Ids**        | product id, in the order you type   | off                                  |
| **Specific SKUs**               | SKU, in the order you type          | off                                  |
| **Distance from user**          | inventory location, **within** N km | off                                  |

**Custom Rule** adds a row for any custom field your products carry. See [Add a custom rule to a product feed](https://releva.ai/documentation/guides/product-feeds/add-a-custom-rule-to-a-product-feed/).

### Where a rule gets its value

* **manual**: you type the value. Text rows accept several values separated by `|` (no spaces) and the placeholders `{{any}}`, `{{pageContext}}` and `{{userFavorite}}`. Number rows take **from** and **to**; date rows take two dates.
* **user’s favorite**: the value comes from the products the customer recently viewed or added to the cart, so it differs per customer. **products considered** (1 to 20) limits how many recent products count. Not available for **Ads** feeds.
* **page context**: the value comes from the page the visitor is on. **Web** feeds only.

With **user’s favorite** or **page context** on a number row, a **lower bound multiplier** and **upper bound multiplier** widen the range around the reference value.

## Algorithms

The algorithm list depends on the scope, and the **?** next to **Algorithm** in the form shows every algorithm with its description. Among the most used:

| Algorithm                                | Description from the form                                                                     |
| ---------------------------------------- | --------------------------------------------------------------------------------------------- |
| **Popular Products**                     | Popular products which customers view, search and purchase often.                             |
| **Most Viewed Products**                 | Products that are frequently viewed                                                           |
| **Trending Products (Recently Popular)** | Products ranked by the increase in their popularity (first derivative of popularity)          |
| **Hot Products (Very Recently Popular)** | Products ranked by the rate of increase in their popularity (second derivative of popularity) |

**New Products** and **Last Search New Products** add a **Freshness filter** (1 to 30 days). **Products from latest event** needs an **Event** to read products from. Deep AI algorithms appear only when they are enabled for your shop.

## Where feeds are used

The feed card on **Product Feeds** shows badges for the Product Blocks (grouped by page), emails, Viber messages and push notifications that use it. Inside those elements you pick a feed with a selector and can adjust it in the **Customize product feed** dialog, which warns that modifying a feed affects all the elements that use it.

Deleting a feed asks for confirmation (**Are you sure?** / “This action cannot be undone!”) and does not check whether anything still uses the feed. Check the badges on the card before you delete.

## Statistics

Clicks and purchases attributed to a feed are summed on its card (**Clicks**, **Purchases**, **Revenue**, last 30 days by default) and on its **Statistics** page (last 7 days by default). See [Check how a product feed performs](https://releva.ai/documentation/guides/product-feeds/check-how-a-product-feed-performs/).

## Next steps

* [Create a product feed](https://releva.ai/documentation/guides/product-feeds/create-a-product-feed/): Build your first feed by choosing a scope, an algorithm, boosts and filters.
* [Add a custom rule to a product feed](https://releva.ai/documentation/guides/product-feeds/add-a-custom-rule-to-a-product-feed/): Boost, bury, include or exclude products by one of your own product fields.
* [Check how a product feed performs](https://releva.ai/documentation/guides/product-feeds/check-how-a-product-feed-performs/): Read the clicks, purchases and revenue a feed brings.
* [How your catalog gets into Releva](https://releva.ai/documentation/learn/catalog/how-your-catalog-gets-into-releva/): Learn how the products your feeds pick from reach Releva and stay up to date.