
By means of the attribute recommendations you can display a frame with the personalized item attribute without showing the items in the recommendation frame. This way, you create unique and personalized sets that promote brands, categories, style, or any other features of the items.

## Distributing recommendations
---
You can use the ID of the recommendation and [inject it with a snippet](/docs/assets/snippets) in other types of communication, such as:
- [dynamic content](/docs/campaign/dynamiccontent) - this way you can show the recommendations on your website.
- [email](/docs/campaign/e-mail) - this way you can send out recommended items through emails.
- mobile application - you can use [documents](/docs/assets/documents) to build your own mobile app and show the recommended items.
- [mobile push](/docs/campaign/Mobile) - you can send recommendations through notifications in your mobile application.
- [web push](/docs/campaign/Webpush) - this way you can send notifications to your customers through a web browser.
- [SMS](/docs/campaign/SMS) - this way you can reach your customers with recommendations on their mobile.

## Requirements
---
- You must [configure the AI engine](/docs/settings/configuration/ai-engine-configuration/engine-configuration-for-recommendations) for this recommendation type.
- [Create an item catalog](/docs/ai-hub/recommendations-v2/item-feed-requirements)
- Optionally, create a complementary [metadata catalog](/docs/ai-hub/item-feed/metadata-catalog) that includes additional information about items

## Select feed and recommendation type
---
Select the feed from which items will be sourced to recommendations and the type of recommendations to be displayed.

1. Go to <img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/icons/ai-hub-icon.svg" alt="Image presents the AI Hub icon" class="icon"> **AI Hub > (AI Recommendations) Models > Add recommendation**.
2. Enter the name of the recommendation (it is only visible on the list of recommendations).
1. In the **Type & Items feed** section, click **Define**.
2. From the **Items feed** dropdown list, select an item feed.
3. Under **Recommendation type**, click **Select model**.
4. On the pop-up that opens, select the **Attribute** model.  
    If the recommendation is disabled, it means the AI engine is not trained yet.
    
   <div class="admonition admonition-tip"><div class="admonition-icon"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2.5"><path stroke-linecap="round" stroke-linejoin="round" d="M9.663 17h4.673M12 3v1m6.364 1.636l-.707.707M21 12h-1M4 12H3m3.343-5.657l-.707-.707m2.828 9.9a5 5 0 117.072 0l-.548.547A3.374 3.374 0 0014 18.469V19a2 2 0 11-4 0v-.531c0-.895-.356-1.754-.988-2.386l-.548-.547z" /></svg></div><div class="admonition-body"><div class="admonition-content">

   Learn more about:
   - [recommendation types](/docs/ai-hub/recommendations-v2/recommendation-types)
   - [recommendation statuses](/docs/settings/configuration/ai-engine-configuration/model-status)

   </div></div></div>

5. Click **Apply**.
4. Optionally, from the **Metadata catalog** dropdown, select the catalog which includes additional information about items in your feed.  
    
   <div class="admonition admonition-note"><div class="admonition-icon"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2.5"><path stroke-linecap="round" stroke-linejoin="round" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" /></svg></div><div class="admonition-body"><div class="admonition-content">

   More information about metadata catalogs is available [here](/docs/ai-hub/item-feed/metadata-catalog).

   </div></div></div>

4. Confirm the settings by clicking **Apply**.  

## Configure item settings
---

The next step is to define the items to be displayed in the recommendation frame. You can use slots to assign space in your recommendation frame to specific items. In the settings of a single slot, you can declare the number of items and the attribute based on which the items will be recommended.

A recommendation must include at least one slot.

### Adding slots

1. In the **Items** section, click **Define**.
3. Click <img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/docs/analytics/_gfx/plus-button.png" alt="Plus icon" class="icon"> button.
4. If you want to name the slot, hover over the **Unnamed slot** tab and double click it.
2. When adding multiple slots, you can define their order by dragging and dropping the tabs into the desired sequence. The slot represented by the leftmost tab is considered the first slot. For more slot order options, refer to the [Define slot and item ordering](#define-slot-order) section.
5. To proceed to the slot settings, click the tab with the slot.
6. In the **Number of items** subsection, enter the minimum and maximum number of items to include in the slot.
4. From the **Item attribute** dropdown, choose the feature of the item based on which the items will be selected to the section or sections in the slot.  
6. To manage the variety of items in the sections, use **Static filters** and **Elastic filters**.  
    
   <details class="accordion"><summary>Elastic filters explained</summary><div class="accordion-content"><p>Apart from selecting the items to be displayed in the recommendation frame, the elastic filter supplements the recommendation frame if it’s not entirely filled up with items. For example, if you select to display up to 10 items, and you have only 5 items that meet the conditions of elastic filter to be displayed in the recommendation frame, then the empty slots will be filled with items which do not match elastic filter (based on scoring of each model).</p></div></details>

    
   <details class="accordion"><summary>Static filters explained</summary><div class="accordion-content"><p> When you use a static filter, it shows the fixed number of items that match the conditions of the filter. If there are not enough items to fill in the recommendation frame (the number you entered in the step 2), the recommendation frame is not displayed at all. </p> <ul> <li>If you want to <a href="/docs/settings/configuration/ai-engine-configuration/engine-configuration-for-recommendations/#selecting-recommendation-types-and-default-filters">apply the global item filter</a> defined for the recommendation model based on which you&#39;re creating the campaign, enable <strong>Apply Items Global Filters</strong>. Enabling this toggle applies the global item filters and they work in combination with other filters in the slot.</li> <li>If you want to apply custom static filters for the slot, click <strong>Define filter</strong>. Select one of the filter creators:<ul> <li><a href="/docs/ai-hub/recommendations-v2/recommendation-filters/#visual-builder">visual builder</a></li> <li><a href="/docs/ai-hub/recommendations-v2/recommendation-filters/#iql-query">IQL query wizard</a></li> </ul> </li> </ul></div></details>
  
    
   <div class="admonition admonition-note"><div class="admonition-icon"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2.5"><path stroke-linecap="round" stroke-linejoin="round" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" /></svg></div><div class="admonition-body"><div class="admonition-content">

   - You can read how to build conditions based on the `category` attribute [here](/docs/ai-hub/recommendations-v2/recommendation-filters#the-category-attribute).
   - You can learn more about [filters](/docs/ai-hub/recommendations-v2/recommendation-filters) in recommendations and see [examples of use](/docs/ai-hub/recommendations-v2/recommendation-filters-examples).

   </div></div></div>

7. Save the changes by clicking **Apply**.  


### Define slot order
---

In this section, you can define the order of slots. However, defining the order of items within the slots is impossible for this recommendation type. Instead, the items are automatically arranged based on the Personalized recommendation model. 

<figure>
<img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/docs/campaign/_gfx/slot-ordering.png" alt="A form for configuring slot order" class="large">
<figcaption> A form for configuring slot order </figcaption>
</figure>

1. In the **Slots and items ordering** section, click **Define**.
2. To define the order of slots and order of items within the slots, in the **Slots and items ordering** subsection, select one of the following options:
    - **Arrange items in slot order**:
        - the slots will be presented in the order defined in the **Items** section. 
        - the order of items is arranged based on results from the Personalization model.
    - **Arrange items ignoring slots and its order**: the slots will be ignored and the order of items will be arranged according to results of from Personalized model.


### Define the boosting factors
---
You can increase probability of appearing in the recommendation frame. You can boost the items in three ways (both can be used at the same time):
- **Metric** boosting uses pre-defined item popularity metrics to influence item scoring. Metric boosting is available only for the Similar, Cart, Visual similarity recommendation types.
- **Attribute** boosting influences item scoring depending on rules applied to the item's attributes. This is done by applying a filter to items and adjusting the score of those items that match the filter. For example, you can increase the scoring of a particular brand without excluding other brands entirely.
- **Personalization** boosting uses the personalization model to influence the items' scoring according to the preferences of each customer - items that fit their preferences have a higher probability of appearing in the recommendation frame. You can manage the influence of personalization model on boosting by using the Impact scrollbar. Personalization boosting is available for all recommendation types, except for Personalized, Section, and Attribute.   
This element has a significant impact on the model's outcome. For instance, if we set the personalization impact to 80% in the recommendation model based on **Top items**, the suggested items will be influenced mostly by the personalization model (making up 80% of the impact). Meanwhile, the **Top items** model will only contribute 20% to the recommendations (along with other factors like boosting attributes).

<figure><img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/docs/campaign/_gfx/recov2-boosting.png" class="large" alt="An example of a Boosting section with metric boosting used to promote items, attribute boosting used to demote items and personalization boosting"><figcaption>An example of a Boosting section with metric boosting used to promote items, attribute boosting used to demote items and personalization boosting</figcaption></figure>

1. In the **Boosting** section, click **Define**.
2. **Metric boosting**:
    1. Click **Select** and select a metric to use for adjusting the score.
    2. Choose the **Promote** (default) or **Demote** option.
    3. Use the slider to determine how much you want the metric to influence the score of the items.
3. **Attribute boosting**:
    1. Click **Add rule**.
    2. Click the created rule to open its settings.
    3. In the **Items scope** section, click **Define filter**.  
        Items that meet the filter will have their scores adjusted. To learn how to build filters, see [Recommendation filters](/docs/ai-hub/recommendations-v2/recommendation-filters).
    4. Choose the **Promote** (default) or **Demote** option.
    5. Use the slider to determine how much you want the metric to influence the score of the items.
4. **Personalization**:
    1. Enable the **Personalization** toggle.
    2. From the Impact scrollbar, select how much you want the personalization model to influence the arrangement of items in the recommendation.
4. Confirm the settings by clicking **Apply**.
### Additional settings
---
<figure><img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/docs/campaign/_gfx/reco-additional-settings.png" class="full" alt="The Additional settings section in the configuration form"><figcaption>The Additional settings section in the configuration form</figcaption></figure>

1. In the **Additional settings** section, click **Define**.
2. If you want to exclude items that the customer already purchased, enable the **Exclude already bought products** option.  
  This option will exclude up to 100 items that were purchased within a specific number of days, as defined in the **Since** field, which appears after enabling the option.  
Optionally, you can also set this option as elastic, which will work as an [elastic filter](/docs/ai-hub/recommendations-v2/recommendation-filters#elastic-filter).
5. If you want to source the item context from an aggregate or expression results instead of the website, enable the **Item context from analytics** toggle. Then from the dropdown list, select the analysis whose result will be treated as the item context.      
     On the basis of the item context, the engine selects the items to display in the recommendation. By default, the recommendation sources the item context from the product page where it is implemented. This option lets you override this setting, so the item context will be taken from the result of the aggregate or expression that returns for example, a recently viewed item, favorite items, recently purchased items or items purchased the most frequently.
    
   <div class="admonition admonition-important"><div class="admonition-icon"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2.5"><path stroke-linecap="round" stroke-linejoin="round" d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" /></svg></div><div class="admonition-body"><div class="admonition-content">

   This option is available for all recommendation types except for Recent interactions and Last seen.

   </div></div></div>

6. Optionally, you can assign a slug to the recommendation. In such a case, enable the **Recommendation slug** toggle.  
    This option lets you assign a user-friendly, unique identifier of the recommendation which you can use to fetch recommendation campaign instead of its ID. The slug can be edited at any time.
    In the **Enter unique slug name** field, enter the name containing 3 to 25 characters. You can only use:
      - lowercase Latin alphabet letters (a-z)
      - digits (0-9)
      - `-` but it can't be the first and/or last character
7. To confirm the settings in the **Additional settings** section, click **Apply**.
### Saving the recommendation
---

To save the recommendation:  
- as a draft, click **Finish later**.
- and activate the recommendation, click **Save**.

Once you activate the recommendation, you can use it as described in the [Distributing recommendations](#distributing-recommendations) section.