Skip to main content
Sitecore Documentation
  • Learn
  • Downloads
  • Changelog
  • Roadmap
PersonalizeCloud Portal
Sitecore Personalize
        • Getting started
            • Create a variant using a web template
            • Create a variant using custom code
            • Use HTML
            • Use CSS
            • Use JavaScript
            • Inserting an experiment in your HTML
        • Using traffic allocation and variant traffic assignment
        • Target a webpage
        • Apply a condition
        • Apply a segment
        • Use a decision model
    • SitecoreAI experiments
    • Using the experiment list
    • Manage experiment details
    • Set automated post-test actions
    • Set up email notifications
    • Duplicate, delete, and view details
  • Using client-side JavaScript
  • Glossary
  1. Introduction to experiments in Sitecore Personalize
  1. Sitecore Personalize
  2. Introduction to experiments in Sitecore Personalize
  3. Introduction to web experiments in Sitecore Personalize

Use HTML in a web experiment

You can HTML in a variant for an experiment, which is particularly useful for facilitating 1:1 personalization by running dynamic data.

Most variants must also pass guest data to your organization's website, for example, the guest's first name, location, and loyalty number. To do this, you must configure the API request to include the dynamic data so that when the variant executes, the data is requested from the server and then passed to the variant.

You can use handlebars.js to access nested values by index from the API response. For example, you might want to display offers in an experiment that are returned from a decision model. Because the offer is a value that is nested in an array, you must use the array.index or array.{index} handlebars.js syntax.

If the web experiment is configured with a decision model, you can insert attributes returned by the decision model into the HTML.

To use HTML in a web experiment:

  1. In the Experiment variants tile, click the Edit icon next to the variant you want to configure.

  2. In the code editor, on the HTML tab, enter any HTML that you want to use in the web experiment.

  3. To insert dynamic data into HTML, on the Data tab, in the Data Selector search box, enter a guest's email address or other identifier to search. This enables you to access data model attributes and paths.

    Tip

    If there is a guest whose data you often use when configuring or testing code, click the star icon to bookmark the guest so you no longer have to search for them.

    Editing the HTML to apply personalization in a variant.
  4. To include dynamic guest data, under the Guest data model tree, click Copy icon and click Copy Path as Handlebars.

  5. To include dynamic data from the decision model response, expand the Decision Model Response tree, click Copy icon and Copy Path as Handlebars.

  6. To include dynamic data from the experience response, expand the Experience Response tree, click Copy icon and Copy Path as Handlebars.

  7. On the HTML tab, paste the data and click Save.

  8. Click to close the code editor.

    You must also include the dynamic data when you compose the API request. This ensures that when the experience executes, the server requests the dynamic data and passes it to the variant.

If you have suggestions for improving this article, let us know!

Documentation Assistant

This assistant uses AI to generate responses based on Sitecore documentation. While it has access to official sources, answers may be incomplete or inaccurate and should not be considered official advice or support.
Powered by
k
kapa.ai
Protected by reCAPTCHA

© Copyright 2026, Sitecore A/S or a Sitecore affiliated company.
All rights reserved.

Privacy policySitecore Trust CenterTerms of use