--- title: Configured Commerce + Product Recommendations slug: optimizely-one/configured-commerce-product-recommendations docTags: createdAt: 2026-07-20T15:44:33.739Z --- You can integrate Optimizely Configured Commerce and Optimizely Product Recommendations to increase user conversions. See the [Product Recommendations](docId:3kltPwJ4UIAbJKcELgAKX) documentation to learn more. :::hint{type="info"} **Note** Optimizely includes the Product Recommendations JavaScript in the base themes and blueprints. You may need to manually add the peerius.js file for custom themes and blueprints. ::: ## Generate the Products RSS Feed file in the Admin Console 1. Go to the Configured Commerce **Admin Console** > **Administration** > **System** > **Settings**. 2. Click the **Integration** tab, then go to **Integration Connectors**. 3. Toggle **Enable Product Recommendations** to **Yes**. This automatically creates two jobs: **Export Products RSS Feed** and **Export Historical Orders**. ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/GFzjccMLxz4kllVvc7Gu4-20260720-150147.png" size="100" alt="EnableProductRecs.png" isUploading="false" showCaption="false"} 4. Go to **Administration** > **Jobs** > **Job Definitions**. ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/H4GxtASTqnpu3VvQZqHKN-20260720-150147.png" size="100" alt="ExportProductsRSSFeed.png" isUploading="false" showCaption="false"} 5. Click the **Edit** icon on the **Export Products RSS Feed Job**, and click **More (...)** to schedule the job. Remember to fill in the **Website Name** on the Schedule Job modal. Click **Schedule Job** when finished. ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/dSMUWfPHTucU9tW4mUJ9I-20260720-150147.png" size="100" alt="ScheduleJob.png" isUploading="false" showCaption="false"} 6. Go to **Library** > **Media** after you run the job, and open **UserFiles** > **\_system** > **ProductRecommendationFeed**. Ensure that it contains a Products\_RSS\_Feed-.xml file with your product data. ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/B1lQYEF3TVMbWHAzqqSYS-20260720-150147.png" size="100" alt="ProductRecsFeed.png" isUploading="false" showCaption="false"} ## Import your Products RSS Feed file to the Product Recommendations portal :::hint{type="info"} **Note** You must work with your onboarding team to complete this step. If you are out of onboarding, email [support@optimizely.com](mailto\:support@optimizely.com) and CC your Customer Success Manager. ::: 1. Go to the Product Recommendations portal and click **Admin** > **Site Management** > **Feed configuration** > **Configure**. 2. Set **Feed type** to** Generic download**. 3. Enter **\*\*\*\*/api/v1/productsrssfeed** in the **Feed URL** field. 4. Select your **Default location**. In general, select the language code for the default website language. ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/EywOiIbsrHicfEGnNjam4-20260720-150147.png" size="100" alt="configcommprodrecs5.png" isUploading="false" showCaption="false"} 5. Select the **History** tab and click **Run feed**. ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/pw5XEg61qETCG6vpXpFkw-20260720-150147.png" size="100" alt="configcommprodrecs6.png" isUploading="false" showCaption="false"} 6. Select your site from the modal that appears, then click **Run feed** again. ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/nmBWNTTPoz_eDuvODn783-20260720-150147.png" size="100" alt="configcommprodrecs7.png" isUploading="false" showCaption="false"} 7. Wait for the feed to import successfully. If the import fails, check the error message and contact Optimizely support. 8. Set a schedule for the feed to run. Optimizely recommends having the feed run daily 15-30 minutes after the feed updates from Configured Commerce. ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/malJ5kY2EmzYp1mR6iaHR-20260720-150147.png" size="100" alt="SetSchedule.png" isUploading="false" showCaption="false"} ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/WBliVQFTiCGGIXvWqvczM-20260720-150147.png" size="100" alt="Schedule.png" isUploading="false" showCaption="false"} ## Configure tracking in the Product Recommendations portal You must work with your onboarding team to complete this step. If you are out of onboarding, email [support@optimizely.com](mailto\:support@optimizely.com) and CC your Customer Success Manager. 1. Go to **Admin > Tracking > Domains**. 2. Click **Add Domain** and input your site domain. Do not add `https://` or `www`. ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/XKZc6apHMIKl33gKfJ9nV-20260720-150148.png" size="100" alt="AddDomain.png" isUploading="false" showCaption="false"} ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/AzkNAqklrM7iSX0Q2augw-20260720-150148.png" size="100" alt="List of Domains.png" isUploading="false" showCaption="false"} :::Paragraph{indent="1"} Your domain is now whitelisted and can receive tracking requests. ::: 3. Go to the **Script** tab. 4. Ensure **Tracking script type** is set to **Generic format**. You should now have tracking and your feed setup. These are the two fundamental requirements for Product Recommendations to work. You can now create widgets for the website and adjust the strategies to reflect the recommendations for your customers. ## Configure tracking in the Admin Console After creating the feed, you must adjust a few settings to ensure tracking works as intended. ![ProductRecsSettings.png](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/noBg_MqFif_b6Mk5G3DC4-20260720-150147.png) You should update three areas: - **Peerius Tracking URL** – This depends on what environment you are working on. - UAT – `//.uat.productrecs.optimizely.com/tracker/peerius.page` - PROD (SE) – `//.peerius.episerver.net/tracker/peerius.page` - PROD (US) – `//.uswe01.productrecs.episerver.net/tracker/peerius.page` - **Peerius Site Name** – This is the name given to your Product Recommendation instance. You can find this in the Product Recommendatons portal: ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/F9JxMhuvIAYn4PsT1z4v4-20260720-150148.png" size="100" alt="PeeriusSiteName.png" isUploading="false" showCaption="false"} :::Paragraph{indent="1"} This example has datademosite2 as the Site Name. ::: - **Peerius API Version** – This should always be **v1\_4**. After saving the settings, check your evironments to see if tracking is live. 1. Go to your website. 2. Open up the developer console and go to the **Network** tab. 3. Search for *peerius* and hit refresh. You should see **peerius.page**. You can also go to the **Sources** tab and look for `.uat.productrecs`, `.uswe01`, or `.peerius.episerver`. You should see `peerius.page`, `tracker.page`, and `trackerform.page`. If you do not see tracking, contact your dedicated onboarding team. If you are out of onboarding, email [support@optimizely.com](mailto\:support@optimizely.com) and CC your Customer Success Manager. ## Configure widgets in the Product Recommendations portal 1. Go to the Product Recommendations portal and click **Configuration** > **Product Recommendations** > **Widgets** and [create your desired widgets](docId:3kltPwJ4UIAbJKcELgAKX). ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/RsXiPSTJKfVorvrH5Y38w-20260720-150148.png" size="100" alt="configcommprodrecs8.png" isUploading="false" showCaption="false"} 2. Go to **Widgets per page** and assign widgets to the relevant pages. ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/0cgre2uvF9RPYqPZS7mb3-20260720-150148.png" size="100" alt="configcommprodrecs9.png" isUploading="false" showCaption="false"} ## Configure Recommended Product widgets in Classic CMS 1. Go to the Configured Commerce Classic CMS by adding */contentadmin* to the end of your site URL or by selecting **Content Editor (CMS)** from the Dashboard within the Admin Console. 2. Click the **Edit **icon. 3. Select a page in the page tree. 4. Click **Add Content**. 5. Select the **Recommended Products** widget. 6. Choose the **Number of Products to Display**. 7. Set the **Product Information to Display**, the positioning, or other settings as desired. 8. Click **Save**, then click **Publish**. ## Configure Product Recommendations carousel widgets in Spire CMS 1. Go to the Configured Commerce Spire CMS by adding* /contentadmin* to the end of your site URL or by selecting **Content Editor (CMS)** from the Dashboard within the Admin Console. 2. Click the **Edit** icon. 3. Select a page in the page tree. 4. Click **Add Widget**, then add [Product Carousel](docId\:hC1Sku-K4EbiX1DONKHvm). ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Xlnn51sO30QNU_V3dy_GH-20260720-150148.png" size="100" alt="ProductCarouselWidget.png" isUploading="false" showCaption="false"} 5. Select **Recommended Products **for **Carousel Type**. You can also change the **Widget Position** if you plan to use several Product Recommendations widgets. ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/69KyQwQgjMGyaPj6d2Ut6-20260720-150148.png" size="100" alt="configcommprodrecs11.png" isUploading="false" showCaption="false"} 6. Click **Save**, then click **Publish**.  :::hint{type="info"} **Note** If you serve multiple widgets on a page, such as on a product detail page, ensure the second widget has its **WIDGET POSITION** updated to **2**. :::