> ## Documentation Index
> Fetch the complete documentation index at: https://algolia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Recommended for you

> Surface items personalized to your users.

export const AlgoliaRecommend = () => <svg xmlns="http://www.w3.org/2000/svg" className="inline" viewBox="0 0 80 80" width="20" height="20" fill="none" role="presentation" ariaLabel="Algolia Recommend">
    <path d="m50 65-4 12H34l-4-12h20Z" fill="#36395A"></path>
    <path d="M68 32c0 15.464-12.536 28-28 28S12 47.464 12 32 24.536 4 40 4s28 12.536 28 28Z" fill="#FF2A6A"></path>
    <path d="M43 34V17L26 34h17Z" fill="#fff"></path>
    <path d="M37 30v17l17-17H37Z" fill="#fff"></path>
  </svg>;

export const SearchRequest = () => <Tooltip tip="A search request is a single HTTP call to the Algolia Search API that can run one or more search operations. It can include multiple queries, for example, when querying several indices at once.">
    search request
  </Tooltip>;

export const Application = () => <Tooltip tip="An Algolia application is a self-contained environment with its own indices, configuration, and API keys. Applications don't share data or settings with each other.">
    application
  </Tooltip>;

Recommended for you surfaces items that best align with the user's interests based on their [affinities](/doc/guides/personalization/classic-personalization/what-is-personalization/in-depth/how-personalization-works#translate-user-behavior-into-affinities-through-events). It can be added to various pages, such as the homepage or category pages, to provide a personalized shopping experience.

<Callout icon="flask-conical" color="#14b8a6">
  This is a **beta feature** according to [Algolia's Terms of Service ("Beta Services")](https://www.algolia.com/policies/terms/).
</Callout>

Recommended for you is compatible with both [Classic](/doc/guides/personalization/classic-personalization/what-is-personalization) and [Advanced](/doc/guides/personalization/advanced-personalization/what-is-advanced-personalization) Personalization.

### Before you begin

<Callout icon="credit-card" color="#c084fc">
  This feature isn't available on every plan.
  Refer to your [pricing plan](https://www.algolia.com/pricing) to see if it's included.
</Callout>

### How recommended for you works

Personalized recommendations use the same Recommend models, but they incorporate user affinities to tailor the recommendations to individual users.

The recommendations are re-ranked based on the user's affinities, which are derived from their interactions and preferences.

### Enable recommended for you

1. Enable [Classic](/doc/guides/personalization/classic-personalization/what-is-personalization) or [Advanced](/doc/guides/personalization/advanced-personalization/what-is-advanced-personalization) Personalization.

2. Go to the [Algolia dashboard](https://dashboard.algolia.com/recommend) and select your Algolia <Application />.

3. On the left sidebar, select <AlgoliaRecommend /> **Recommend**.

4. Select **Recommended for you** and click **Start using**.

   <img src="https://mintcdn.com/algolia/QUuhkPGiow1bP-ae/images/guides/recommend/recommended-for-you-model-card.png?fit=max&auto=format&n=QUuhkPGiow1bP-ae&q=85&s=cd6f75a370ceb6e3ef4934efcb2f7bc4" alt="Screenshot of a 'Recommended for you' section with a 'Start using' button and a note that the Personalization feature needs to be trained." width="298" height="427" data-path="images/guides/recommend/recommended-for-you-model-card.png" />

### Add Recommended for you to your app

You can add a Recommended for you to your app using the [Recommend API](/doc/rest-api/recommend/get-recommendations).

In the <SearchRequest />,
`queryParameters` can include any valid [search parameters](/doc/api-reference/api-parameters) such as [`facetFilters`](/doc/api-reference/api-parameters/facetFilters) or [`hitsPerPage`](/doc/api-reference/api-parameters/hitsPerPage).
A [`userToken`](/doc/api-reference/api-parameters/userToken) is required.

```json JSON icon=braces theme={"system"}
{
  "requests": [
    {
      "model": "recommended-for-you",
      "indexName": "<YOUR_INDEX_NAME>",
      "threshold": 0,
      "queryParameters": {
        "userToken": "user-1234"
      }
    }
  ]
}
```

InstantSearch doesn't support Recommended for you.