# “Recommended For You” Rows

> Source: https://docs.recombee.com/recipes/video/fully-personalized-homepage/recommended-for-you-rows

> For the complete documentation index, see [llms.txt](/llms.txt).

**Table of contents**

* [Introduction](#introduction)
* [Scenario Setup](#scenario-setup)
* [Logic](#logic)
* [Filters](#filters)
* [Boosters](#boosters)
* [Requesting Recommendations](#requesting-recommendations)

# “Recommended For You” Rows

![](/img/recipes/video/recommended-for-you-rows.png) 

## Introduction

With a particular emphasis on customizable filters, our advanced recommendation algorithms curate rows on your viewers' homepage that align precisely with their unique preferences. They can enjoy a homepage that truly reflects their taste, ensuring each video suggestion is a perfect match.

You can add a "For You" row, along with other personalized rows such as a "New Releases For You", a row with content from user's country or area, and much more thanks to our flexible [filters](#filters).

## Scenario Setup

In the Recombee Admin UI, navigate to the **[Scenarios](/scenarios)** section and choose **Create Scenario**.

1. Enter a **Scenario ID**. The Scenario ID depends on what content will be shown in the particular box (what Filter will be applied), so it can be e.g. _top-picks-for-you_, _local-content-for-you_, or _new-releases-for-you_
2. Choose **Recommendation type** \- _[Items to User](/api#recommend-items-to-user)_ (as we want to personalize the content based on the user’s watching history)

![Admin UI - Scenario Setup](/img/recipes/video/recommended-for-you-rows-create-scenario.png)

## Logic

The [Logic](/recommendation_logics) defines the behavior of the recommendation engine.

* Choose the **[video:personal](/recommendation_logics#video-personal)** logic type from the **Video** models to recommend assets based on the user’s watching history

Based on the `assetType` parameter you can choose what type of assets will be returned (e.g. movies, series, episodes, or movies and episodes, etc.).

Using the `excludeAlreadyWatched` parameter you can either allow or filter out the titles the user has already watched.

![Admin UI - Logic](/img/recipes/video/recommended-for-you-rows-logic.png)

## Filters

New Releases

You may want to create a **Latest Releases For You** row and show only assets added in e.g. the last two weeks.

1. Navigate to **[Filters](/scenarios#filters)** tab and **Add first filter**
2. Find _Recent items_ and click on **+**
3. Specify which **property** in your Items catalog specifies the **publish date**
4. Enter maximal age in days

![Admin UI - Filter - Recent Items](/img/recipes/video/filter-recent-items.png)

Local Content

You may want to create a **Local Content For You** row and show only the content specific to the user’s country, state, city, etc.

1. Navigate to **[Business Rules](/reql#business-rules)** section and **Create Rule**
2. Enter a **Rule name**, such as _"User Local Content"_
3. Choose **Rule Type** \- _Filter_
4. Choose **Entity Type** \- _Items_
5. Assuming the user has a _country_ user **property** and the assets have a _countries_ item **property**, that contains the countries to which the asset is local, the ReQL expression can look like this:

```
context_user["country"] in 'countries'
```

[![Admin UI - Filter - User Local Content - ReQL](/img/recipes/video/filter-user-local-content-reql.png)](/img/recipes/video/filter-user-local-content-reql.png)

**After creating** the [Filter](/scenarios#filters), you can apply the rule to your Scenario in the Filters tab.

[![Admin UI - Filter - User Local Content](/img/recipes/video/filter-user-local-content.png)](/img/recipes/video/filter-user-local-content.png)

If the locations of the user and the videos are specified by latitude and longitude, you can use the [Geographical ReQL functions](/reql_functions#geographical-functions), such as [earth\_distance](/reql_functions#earth-distance).

Available Assets (Global Settings)

You always want to recommend only movies, series, and episodes that are currently available to watch for your users. Therefore you need to apply a [**Filter**](/scenarios#filters) rule to allow only such assets.

As it would be tedious and prone to error to add this rule to all the Scenarios, this rule shall be added to the [**Global Settings**](/scenarios#scenarios-in-admin-ui-global-settings), so it is always applied everywhere.

**The particular filter depends on how you specify such assets in your catalog:**

* If you have a **boolean property** that marks the asset as available you can use the predefined _Available items \[boolean\]_ rule.
* If you have a **timestamp property** that specifies when the asset is published (becomes available) you can use the predefined _Published items rule_.
* Or if you have a **licensing window (start date, end date)** you can use the predefined _Items within their licensing window_ rule.
* In every other case, you can create a [**custom filter rule**](/reql) to allow only the available assets according to your own logic.

![Admin UI - Global Settings - Filter](/img/recipes/video/filter.png)

## Boosters

Boost Content Picked by the Editorial Team

You may want to boost the assets the editorial team picked as preferred.

If you export this flag from your CMS as a **boolean property,** you can apply the _Boost editors' picks_ predefined rule in the **Boosters** tab of the **Scenario**.

[![Admin UI - Booster - Boost editors' picks](/img/recipes/video/booster-editor-picks.png)](/img/recipes/video/booster-editor-picks.png)

You can find the appropriate level of boosting using the **Preview.**

[![Admin UI - Booster - Boost editors' picks - Preview](/img/recipes/video/booster-editor-picks-preview.png)](/img/recipes/video/booster-editor-picks-preview.png)

## Requesting Recommendations

There are three ways to get recommendations.

1. **[No-Code Widget](/no-code-widgets)** \- create a No-Code Widget using the **visual editor in the Admin UI.**
2. **[Widget SDKs](/widget-sdks)** \- use the SDK for a [Carousel](/widget-sdks#carousel), [Grid](/widget-sdks#grid) or [Feed](/widget-sdks#feed) to display the recommendations in the design of your choice. Use the [Recommend Items to User endpoint](/api#recommend-items-to-user) when initializing the widget.
3. **[API SDK](/api_clients)** \- request the [Recommend Items to User endpoint](/api#recommend-items-to-user) of the Recombee API using an SDK of your choice.

For more information navigate to the Integration tab of the Scenario in the Admin UI.

In order to request content for multiple rows with a single API request, use the [Batch endpoint](/api#batch) and put the recommendation requests inside it. Set the parameter `distinctRecomms` in order to [deduplicate the assets among the rows](/api#batch-example-using-distinctrecomms-parameter-to-deduplicate-results-in-multiple-boxes).