# Latest News

> Source: https://docs.recombee.com/recipes/news/homepage/latest-news

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

**Table of contents**

* [Introduction](#introduction)
* [Scenario Setup](#scenario-setup)
* [Logic](#logic)
* [Filters](#filters)
* [Requesting Recommendations](#requesting-recommendations)  
   * [Multiple Recommendation Boxes on the Homepage](#multiple-recommendation-boxes-on-the-homepage)

# Latest News

![](/img/recipes/news/latest-news.png) 

## Introduction

The **Latest News** section highlights the most recently published articles on your platform.

This scenario is purely based on recency — it does not take personalization or topic preferences into account. Use it when you want to surface the newest content for all users, regardless of their history or interests.

## Scenario Setup

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

1. Enter a **Scenario ID**, such as _"latest-news"_.
2. Choose **Recommendation type** – _[Items to User](/api#recommend-items-to-user)_.

![Admin UI - Scenario Setup](/img/recipes/news/latest-news-create-scenario.png)

## Logic

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

* Select the **[news:recent](/recommendation_logics#news-recent)** logic type from the **News** models. This Logic ranks articles purely by their publish time, ensuring that the most recently published content appears first.

**The Logic supports the following parameters.**

`publishedTimestamp` The property **(required)** in your item catalog that stores the article's publish time (e.g., `publishedAt`).

`excludeAlreadyRead` Determines whether to exclude articles the user has already read. This is `true` by default, but you can override it.

![Admin UI - Logic](/img/recipes/news/latest-news-logic.png)

## Filters

You can use filters to narrow down the set of articles shown in the Latest News section — for example, to only display news from certain categories.

Tip: Category-Specific News

You may want to create additional boxes on your homepage showing only the **latest articles from a specific category** — such as _“Latest in Politics”_ or _“Latest in Technology”_.

1. Navigate to the **[Filters](/scenarios#filters)** tab and **Add first filter**.
2. **Add one of the following filters** from the library of predefined rules:  
   * **Items from particular category \[string\]** – if articles always belong to a single category  
   * **Items from particular category \[set\]** – if articles can belong to multiple categories
3. Specify which **property** in your item catalog contains the category information.
4. Enter the **Category name** you want to display.

[![Admin UI - Filter - Category-specific News](/img/recipes/news/latest-news-filters.png)](/img/recipes/news/latest-news-filters.png)

## Requesting Recommendations

There are three ways to retrieve the Latest News recommendations.

1. **[No-Code Widget](/no-code-widgets)** – create a No-Code Widget using the **visual editor in the Admin UI** to embed the Latest News section without writing code.
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](/api#recommend-items-to-user) endpoint and specify the `latest-news` scenario when initializing the widget.
3. **[API SDK](/api_clients)** – request the [Recommend Items to User](/api#recommend-items-to-user) endpoint of the Recombee API using an SDK of your choice and specify the `latest-news` scenario.

### Multiple Recommendation Boxes on the Homepage

If your homepage includes multiple recommendation sections — such as [personalized category-based sections](/recipes/news/homepage/personalized-sections-with-reordering) or [top stories](/recipes/news/homepage/top-stories) — you typically want to avoid duplication of content among the boxes. To achieve this:

* Use a single [Batch request](/api#batch) to send all recommendation requests at once.
* Enable the [distinctRecomms parameter](/api#batch-example-using-distinctrecomms-parameter-to-deduplicate-results-in-multiple-boxes) in the batch request to prevent overlapping articles between sections.

The [Widget SDKs](/widget-sdks) handle this functionality automatically.