---
title: Recommendations callback
slug: product-recommendations/docs/recommendations-callback
docTags:
createdAt: 2026-07-30T20:41:30.719Z
---
Optimizely returns product recommendations in the form of a JavaScript callback method. When the product recommendations are ready, they are passed to this callback function in the form of JSON data.
```json
var PeeriusCallbacks={
smartRecs:function(jsonData) {
// implementation ….
}
}
```
The `jsonData` parameter is a list of recommendation widget elements that have the following properties.
:::hint{type="warning"}
**Important**
You must use `postion` (not `widget`) to render recommendations because the `position` value is consistent and ensures your AB tests will continue working.
If your rendering code refers to `widget` instead of `position`, your code will fail to render the recommendations if someone changes the name of the widget.
:::
| Name | | | | Description and usage |
| -------- | ---- | ---------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| widget | | | | \[String]
Name of widget.
Use for information only because this varies during A/B testing.
To determine where to place a widget on the page, use the position attribute, below. |
| alias | | | | \[String]
Alias of the widget.
This is used internally by Optimizely Personalization. It should be used for information only. |
| position | | | | \[String]
Name of the page position for this widget.
This attribute should be used to determine the page position in which to show the widget. It needs to be a unique ID.
This value is stable and should be used to reference (rather than widget). |
| | recs | | | A list of recommendations |
| | | img | | \[String]
URL of the product image. |
| | | title | | \[String]
Product title. |
| | | url | | \[String]
URL to the item's product page. |
| | | refCode | | \[String]
Product reference code. |
| | | prices | | A map in which
- the key is the currency name (such as USD, GBP, and so on)
- the value is a map with unitPrice and salePrice properties. |
| | | | unitPrice | \[Number]
The item's price per unit. |
| | | | salePrice | \[Number]
The item's sale price. |
| | | id | | \[64bit Number]
Recommendation id.
This is used for marking clicks. See [Marking clicks](docId\:x-UWMNCr7HCibp_1X8Mrx). |
| | | attributes | | A list of attributes and their values.
Attributes requested in the tracking request. See [Additional attributes in recommendations](docId:9yjV4ZBn-3FvtUTN-4vDt). |