# Personalized Emailing

> Source: https://docs.recombee.com/recipes/news/personalized-emailing

> 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)  
   * [Requesting Dynamic Content from API](#requesting-dynamic-content-from-api)  
   * [Pre-fetching Recommendations](#pre-fetching-recommendations)

# Personalized Emailing

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

## Introduction

Deliver engaging and relevant newsletters with personalized news content for every reader.

The [news:emailing](/recommendation_logics#news-emailing) Logic is tailored specifically for **periodic email campaigns** — such as daily or weekly digests. It combines the user’s interests with essential unread content, helping them stay informed without missing out on important headlines.

Whether you're sending editorial roundups, topic-specific campaigns, or broad-reaching digests, this Logic ensures each email remains fresh, relevant, and highly personalized.

## Scenario Setup

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

1. Enter a **Scenario ID**, such as _"emailing"_ or a campaign-specific ID (e.g., _"weekly-digest"_).
2. Choose **Recommendation type** – _[Items to User](/api#recommend-items-to-user)_.

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

## Logic

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

* Select the **[news:emailing](/recommendation_logics#news-emailing)** logic type from the **News** models. This Logic is designed to generate personalized selections of articles specifically for email newsletters.

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

It automatically blends:

* **Personalized recommendations** based on the user’s reading behavior and interests.
* **Key unread articles**, ensuring that important stories — which the user hasn't seen yet — are not missed.

This makes it ideal for newsletters where both **engagement and awareness** matter.

## Filters

Filter on Recent Articles

To ensure that your email only includes **fresh news**, apply the _Recent items_ predefined filter:

1. Navigate to the **[Filters](/scenarios#filters)** tab and **Add first filter**.
2. Find _Recent items_ and click **+**.
3. Choose the **property** in your catalog that stores **publish time** (e.g., `publishedAt`).
4. Set the maximum age of articles depending on your campaign frequency:  
   * **1 day** for daily emails  
   * **7 days** for weekly newsletters  
   * Or another interval that fits your content cycle

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

Tip: Category-Specific Campaigns

To focus an email on a specific topic (e.g., _Politics_, _Tech_, _Sports_):

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. Choose the **property** used in your catalog for topics or categories (e.g., `category`, `topics`)
4. Enter the **Category name** you want to display.

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

## Requesting Recommendations

Choose the way of requesting recommendations compatible with your emailing platform

### Requesting Dynamic Content from API

If the emailing platform can fetch the recommendations directly from the Recombee API:

1. Ensure the platform supports the [authentication scheme](/authentication) directly (e.g. in the case of _Customer.io_), or set up a small proxy that authenticates the requests.
2. In case the authentication proxy needs to be set up, please contact [support@recombee.com](mailto:support@recombee.com) for guidance on how your emailing platform can be connected with Recombee.

### Pre-fetching Recommendations

If the emailing platform does not support requesting a 3rd party API but supports adding personalized content unique to each user:

1. Request the recommendations for each user who shall get the email using the [Recommend Items to User endpoint](/api#recommend-items-to-user).
2. Upload the recommendations to the emailing platform.
3. Send the emails.

You can request many recommendations at once using the [Batch endpoint](/api#batch).

You can contact [support@recombee.com](mailto:support@recombee.com) to get more information on how this procedure shall be implemented in the case of your emailing platform.