Skip to main content
Sitecore Documentation
  • Learn
  • Downloads
  • Changelog
  • Roadmap
CDPCloud Portal
Sitecore CDP Developer Documentation
  • Developing with Sitecore CDP
    • Access your data
    • Writing SQL queries
        • Guests
        • Orders
        • Order items
        • Experience definitions
        • Events
        • Sessions
  1. Data entities reference
  1. Sitecore CDP Developer Documentation
  2. Data lake export service

Guests

The following table includes some of the attributes that are available in the guests entity.

Your organization will have additional attributes.

AttributeDescriptionTypeExample
meta_refA unique ID of the guest generated by Sitecore CDP.string"9d94ee11-7043-4b71-980c-a777d00a7b46"
bxtA collection of name-value pairs that store various guest-related data points. For a customer guest type, this can include subscription and identifier attributes. This attribute is owned and maintained by Sitecore. See the following table for a list of fields stored in the bxt attribute.map{gender=unknown, firstName=John, lastName=Doe}
core_first_seen_atThe first time the guest interacted with your brand, as seen by Sitecore CDP.ISO 8601 Date/Time UTC"2020-01-01T16:17
.000Z"
core_last_seen_atThe last time the guest interacted with your brand, as seen by Sitecore CDP.ISO 8601 Date/Time UTC"2026-09-08T16:17
.000Z"
meta_client_keyThe unique client reference that identifies your organization.string"mhbWwbHYfhpheu86hp60oR76S4jQMmZr"
meta_created_atDate and time when the guest record was created in Sitecore CDP.ISO 8601 Date/Time UTC"2020-01-01T16:17
.000Z"
meta_modified_atDate and time when the guest record was last modified in Sitecore CDP.ISO 8601 Date/Time UTC"2026-09-08T16:17
.000Z"
typeThe level of identity that Sitecore CDP obtains for a guest.string"CUSTOMER", "VISITOR"
extA collection of name/value pairs that store your organization's guest data extensions.map{generation=millennial, loyaltyLevel=silver}
session_traitsA collection of name/value pairs that store your customer's session traits as defined by you in Sitecore CDP.map{countPageViews=0, homeLocation=Dublin}
raw_jsonThe overall guest representation as raw JSON.stringN/A

The following table describes the properties stored in the bxt map field. Different properties might be stored for different guests.

AttributeDescriptionTypeExample
countryThe country of this guest, represented by 2 letters, in ISO 3166-1 alpha-2 format.string"IE"
dateOfBirthThe date of birth of this guest.timestamp2001-02-15T00:00
emailThe email address of this guest.string"[email protected]"
emailsAn array of email addresses of this guest.array["[email protected]","[email protected]"]
firstNameThe first name of this guest.string"Dave"
genderThe gender of this guest.string"unknown"
languageThe language used by this guest, represented by 2 letters, in ISO 3166-1 alpha-2 format.string"EN"
lastNameThe last name of this guest.string"Jones"
phoneNumbersAn array of phone numbers for this guest.array["0123465861", "0123465862"]
postCodeThe post code for this guest.string"AB 1234"
stateThe state for this guest.string"Colorado"
streetThe street address for this gueststring"12 Beaker Street"
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