# Personalized catalog

Personalization allows you to specify the conditions for displaying the item catalog and applying promotions only for specific authorized users. Conditions are defined based on user attributes and allow you to offer items and promotions that are most relevant to particular users.

The following personalization types are available:


* [Xsolla-side personalization](/liveops/promotion-tools/personalization/#guides_personalization_on_xsolla_side). Personalization rules and logic are configured and stored on the Xsolla side. You pass user attributes, and Xsolla uses them to generate a personalized catalog.
* [Partner-side personalization](/liveops/promotion-tools/personalization/#guides_personalization_on_partner_side). You configure personalization rules and logic on your side and send a final catalog payload for a specific user to Xsolla.

<div class="note">
  <b>Note</b><br><br>
  You can use only one personalization type. To change it, follow the
  <a href="/liveops/promotion-tools/personalization/#guides_personalization_change">instructions</a>.
</div>


To configure personalization on the Xsolla side using the Xsolla API:

1. Create items using the API calls from the **Admin** subsection of the [Virtual items and currency](/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list/), [Bundles](/api/catalog/bundles-admin/admin-create-bundle) or [Game keys](/api/catalog/game-keys-admin) groups.
2. [Set up user attributes using the Xsolla Login API](/liveops/promotion-tools/personalization/#web_shop_guide_personalization_setting_attributes) and keep them synchronized by updating data in Xsolla whenever changes occur in your game.
3. Configure personalization for items or promotions:
    * To personalize the item catalog, define catalog display rules using the [Create catalog filter rule](/api/liveops/personalized-catalog/create-filter-rule) API call:
        * In the [attribute_conditions](/api/liveops/personalized-catalog/create-filter-rule#personalized-catalog/create-filter-rule/t=request&path=attribute_conditions) array, specify the conditions that determine item availability based on user attributes.
        * In the [items](/api/liveops/personalized-catalog/create-filter-rule#personalized-catalog/create-filter-rule/t=request&path=items) array, provide the list of items that should be visible to the user if their attributes match the specified conditions.
    * To configure personalized promotions, use the [create and update API calls for the required promotion type](/api/liveops/promotions-discounts/create-item-promotion). In the [attribute_conditions](/api/liveops/promotions-discounts/create-item-promotion) array, specify the conditions that determine promotion availability based on user attributes.

4. Pass the [user JWT](/api/login/getting-user-token?#getting-user-token) with user attributes to the [catalog retrieval API calls](https://developers.xsolla.com/api/catalog/virtual-items-currency-catalog/get-virtual-items) to receive a personalized catalog.

**Sequence for configuring and applying Xsolla-side personalization for item catalog:**

![Personalization for item catalog](https://cdn.xsolla.net/developers/current/images/api_docs/personalization-catalog.png)

**Sequence for configuring and applying Xsolla-side personalization for promotions:**

![Personalization for promotions](https://cdn.xsolla.net/developers/current/images/api_docs/personalization-liveops.png)

<div class="note">
<b>Note</b><br><br>
Detailed information is provided:
<ul>
  <li>in the <a href="/liveops/promotion-tools/personalization/">guide to configuring personalization on the Xsolla side and the partner side</a></li>
  <li>in the step-by-step tutorial on <a href="/doc/shop-builder/tutorials/personalization-tutorial/">item catalog personalization on the Xsolla side</a></li>
</ul>
</div>