--- title: Configure web properties slug: content-recommendations/docs/configure-web-properties docTags: createdAt: 2026-08-05T19:40:08.305Z --- In Optimizely Content Recommendations, you can configure **Web Properties** on the **Content > Properties** page. A web property represents your website within Content Recommendations solution. You can create unique tracking scripts for your site by adding web properties.  ## Add a web property To add a property, complete the following actions:  1. Go to **Content > Properties**. 2. Click **Add Web Property**. ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/h5v1g5cjP2f_iD1Ue0mjM-20260720-150136.png" size="100" isUploading="false" showCaption="false"} 3. Enter the following information: 1. **Title** – Enter the name of the property. 2. **Hostnames** – Enter domains and sub-domains you want to allowlist for content ingestion. Use separate lines for each name.  3. **Collections** – Enter a collection name, such as a theme or topic like *finance* or *retirement*, or expand the drop-down list to select from an existing collection. 4. Click **Save**.  ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/4B5JY6UXoPLpkyLnWlowq-20260720-150136.png) ## Track using JavaScript When you click **Save**, you are redirected to the **Properties > My property > Tracking JavaScript** page. This page provides on-screen instructions for setting up a property.  In the **Options** section, complete the following: 1. **User Identification** – Select the option that best describes the visitors of this property.  2. **Automatic Event Tracking** – Enable this option for sites that dynamically load content, such as with AJAX. This action requires manually triggering `consume` events. By default, this option should remain disabled. 3. **PDF Tracking** – Enable to track PDF files. PDF tracking adds a function to the standard tracking script and picks up PDF links embedded on the page. If you click on the PDF link, it will trigger the scraping and indexing process. The PDF content is indexed, and you can use this to segment, assign to deliveries, and return in Content Recommendations. :::hint{type="info"} **Note** You can also [add an RSS feed ](docId\:szsgTfNPpRfnu9tzKfjvD)to enable PDF tracking. ::: 4. Click **Done**. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/z5HX6WI9vd-fdxF1QVuJm-20260720-150136.png) In the **Installation & Usage** section, you can find information on using a custom solution, inserting canonical tags, adding published dates, and implementing a JavaScript snippet. Use this information only if you are deploying with a manual installation. If you installed Content Recommendations using a NuGet package, you do not need to deploy a separate tracking script, as tracking is included in that installation.   Find the following information in the **Installation & Usage** section: 1. **Caveats** – View the information on which websites may require a custom solution to support tracking properly. Contact your customer success manager if you need to use a custom solution. ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/FemdNtA3b3MmGJ8eJ3PYQ-20260720-150136.png" size="100" isUploading="false" showCaption="false"} 2. **Canonical Tags** – See [Consolidate duplicate URLs](https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls?visit_id=638995785036218469-2683552739\&rd=1) for information on using canonical meta tags. Canonical tags can help prevent article duplication issues.  ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/k5DkfgstU92wWIdJIa8Aa-20260720-150136.png" size="100" isUploading="false" showCaption="false"} 3. **Published Dates** – Click **Copy to Clipboard** to copy the meta tag of the published date of your content. The published date is only imported if it contains the relevant meta tag. You must add these tags, particularly if filtering by published date is useful to you.   ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Fm1XZcJHmW6YIZonjXdrC-20260720-150136.png" size="100" isUploading="false" showCaption="false"} 4. **Include Code** – Click **Copy to Clipboard** to copy and include the JavaScript snippet in the `head` of your webpage. Alternatively, if you use a tag manager like Google Tag Manager, you can use it to include the code.  ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/6E-gsw6ktLh2fcRn1uLDS-20260720-150136.png" size="100" isUploading="false" showCaption="false"} :::hint{type="info"} **Note** **Click Copy to Clipboard** to copy the argument. When you dynamically load your site, you need to manually trigger the system's tracking by calling `track` with the `consume` argument. If you do not manually implement this call, no `consume` events are tracked.  ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/6DMiF0HFHo9741o9YqydR-20260720-150136.png) ::: In the **Optional functionality** section, you can find additional information on tracking events, tracking conversions, and recoding user identifiers.  1. **(Optional) Track Events** – Add event calls, like `consume`, `like`, `dislike`, `share`, `comment`, `group`, and `exit` to the webpage to track additional personalization events. ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/DqG7myQ0FWdycNdVvi7v0-20260720-150136.png" size="100" isUploading="false" showCaption="false"} 2. **(Optional) Tracking Conversions** – Click **Copy to Clipboard** to copy and add a `convert` event to the webpage to track conversions.  :::hint{type="info"} **Note** Content Recommendations cannot ingest granular conversion-level data, such as order ID, price, and so on. ::: ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/VpVmtXFEHqzgNwrUsolyU-20260720-150136.png" size="100" isUploading="false" showCaption="false"} 3. **(Optional) Recoding User Identifiers** – Click **Copy to Clipboard** to copy and add an `identify` event to the webpage to assign identifiers to a user.    ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/xxNM_V2KySbmyz76fudFV-20260720-150136.png" size="100" isUploading="false" showCaption="false"} ## View or edit the web property After making changes to a property, return to the **Properties** page. You can view your property in the list of properties. Click **Edit** to edit your property.  ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Mf3sL6E0IvdZXBSuGYLJ9-20260720-150136.png) You are redirected to the **Properties > Edit** page. Click **Save** after you make the changes. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/pocE-CBEIsbBj89kbjxL5-20260720-150136.png)