Skip to main content
Sitecore Documentation
  • Learn
  • Downloads
  • Changelog
  • Roadmap
PersonalizeCloud Portal
Sitecore Personalize
        • Getting started
        • Target a webpage
        • Apply a condition
        • Apply a segment
        • Use a decision model
            • Use FreeMarker snippets
            • Test the API request
            • Use dynamic experiment data
            • Use dynamic guest data
            • Use dynamic decision model data
    • SitecoreAI experiences
    • Using the experience list
    • Manage experience details
    • Set up email notifications
    • View performance analytics
    • View operational data
    • Duplicate, delete, and view details
  • Using client-side JavaScript
  • Glossary
  1. Introduction to experiences
  1. Sitecore Personalize
  2. Introduction to experiences
  3. Introduction to web experiences in Sitecore Personalize

Use dynamic guest data in the API request for a web experience

You can copy attributes or paths from the guest data model and use them in the API request.

To include dynamic guest data in the API request:

  1. In the code editor, click the API tab.

  2. 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.

  3. Under Guest data model, click Copy icon next to the attribute or path and click Copy Path as FreeMarker.

    Copying guest data to the API request
  4. Paste into the API tab.

    Tip

    There are some situations when you might want to insert a custom field in your API request, using FreeMarker. For example, you might want to retrieve the logged in state of the site visitor. To do this, you can create a custom field called loggedInState. You can then use the following path in FreeMarker when configuring the API request: "customField": "${request.params.customField}"

  5. You must then reference this data again by pasting it into the relevant HTML, CSS, or JavaScript editor.

  6. Click Save.

  7. Click to close the code editor.

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

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

Privacy policySitecore Trust CenterTerms of use