Collections

Contact Properties Glossary

By Josh Slone

updated 16 days ago

This glossary is the full list of supported properties which can be used with Gist and our integrations. Included are the name of the property and a brief description. 

Note: The "key" for each property is the lowercase name of the property with an underscore (_) in any space. For instance, if the property is "Contact Type", the key would be "contact_type". You would use this in liquid content, like liquid email tags and liquid properties in live chat snippets and chat prompts.  

Using Properties

Properties allow for detailed tracking of what your customers and visitors are doing on your site. This information can be used to better: 

  • Market your business
  • Sell your products
  • Segment your audience

There are a number of different properties spread out into five categories:

  • Contact Properties
  • Analytic Properties
  • Email Information Properties
  • Conversion Properties
  • Stripe Properties

Note: Keep in mind this glossary will be updated as we add new properties and integrations.


Now, onto the glossary!

Contact Properties

Property Name
Property Description
EmailA contact's primary email address
User IDa unique identifier to map a contact with a user in your app
Created DateThe date that a contact entered the system
Updated DateThe date the contact's info was last updated
First NameThe contact's first name
Last NameThe contact's last name
Full NameThe contact's full name
Last Contacted DateThe date the contact was last contacted by you or your team
Last Heard From DateThe date the contact last contacted you via chat or email
SalutationThe title used to address the contact
Job TitleThe contact's job title
Company NameThe name of the contact's company. This is separate from the name property of the contact's associated company and can be set independently
Website URL
The contact's company website
Mobile Phone NumberThe contact's mobile phone number
Phone NumberThe contact's primary phone number
Street AddressThe contact's street address, including apartment or unit #
City
A contact's city of residence
StateThe contact's state of residence
CountryThe contact's country of residence. This might be set via import, form, or integration
Postal CodeThe contact's zip code

Fax Number
The contact's primary fax number

Industry
The company's industry

IP Address
The contact's ip address (note: we will track this internally but do not show to users)

Preferred Language
The contact's preferred language for communications. This might be set via import, form, or integration
TagsLabels for your contacts that allow you to create groups of contacts for segmentation
Date of BirthThe date of birth of the contact
GenderThe gender of the contact
Company SizeThe size of the company of the contact


Analytics Properties

Analytic Property
Property Description
First Page SeenThe first page the contact saw on your website. This is automatically set by gist for each contact
Last Page SeenThe last page the contact saw on your website. This is automatically set by gist for each contact
First Referring SiteThe first website that referred the contact to your website. This is automatically set by gist for each contact
Last Referring SiteThe last website that referred the contact to your website. This is automatically set by gist for each contact. This analytics property looks at the last page viewed, so this site can be internal or external
Number of Event CompletionsThe sum of all events the contact has experienced. This is automatically set by gist for each contact
Number of Page ViewsThe sum of all pages the contact has seen on your website. This is automatically set by gist for each contact
Number of Unique Daily SessionsThe total number of days the contact has visited your website or app. This is automatically set by gist for each contact
Time of First SessionThe first time a contact visited your website. This is automatically set by gist for each contact
Time of Last SessionThe last time and date the contact visited your website. This is automatically set by gist for each contact
BrowserThe browser the contact has used to visit your website or app
Browser VersionThe version of the browser the contact has used to visit your website or app
PlatformThe operating system of the device the contact has used to visit your website or app


Email Information Properties

Email Information Properties
Property Description
EU ConsentIndicates if the contact has granted their consent to receive marketing communication
Marketing Emails DeliveredThe number of marketing emails delivered for the current email address. This is automatically set by gist
Marketing Emails BouncedThe number of marketing emails sent from your account that hard or soft bounced (this does not include global bounces, which are bounces in account in gist's system for a permanent reason, such as an invalid recipient)
Marketing Emails OpenedThe number of marketing emails opened. Please note that this value is incremented at most once per email; if the same email is opened multiple times, this value will only increase by one
Marketing Emails ClickedThe number of marketing emails which have had link clicks. Please note that this value is incremented at most once per email; if the same link is clicked multiple times, or multiple links in the same email are clicked, this value will only increase by one
First Marketing Email Sent DateThe date of the earliest email delivery for any marketing email
First Marketing Email Opened DateThe date of the earliest email open for any marketing email
First Marketing Email Clicked DateThe date of the earliest link click for any marketing email
Last Marketing Email Sent DateThe date of the most recent email delivery for any marketing email
Last Marketing Email Opened DateThe date of the most recent email open for any marketing email
Last Marketing Email Clicked DateThe date of the most recent link click for any marketing email
Last Marketing Email Email NameThe name of the last marketing email sent
Unsubscribed from All EmailIndicates that the current email address has opted out of all marketing email from the workspace
Marked Email as SpamIndicates if the contact has reported any marketing email as spam
Has Hard BouncedIndicates if the contact has hard bounced
Sends Since Last EngagementThe number of marketing emails that have been sent since the last engagement (open or link click)


Conversion Properties

Conversion Properties
Property Description
First ConversionThe first form the contact has submitted
First Conversion DateThe date the contact first submitted a form
IP CityThe city reported by the contact's ip address when they fill out a form. This is automatically set by gist and can be used for segmentation and reporting
IP CountryThe country reported by the contact's ip address when they fill out a form. This is automatically set by gist and can be used for segmentation and reporting
IP Country CodeThe state code or region code reported by a contact's ip address. This is automatically set by gist and can be used for segmentation and .Reporting
IP Time ZoneThe time zone reported by a contact's ip address. This is automatically set by gist and can be used for segmentation and reporting. ****this property is used to determine a contact's time zone for the time zone send email feature
Most Recent CityThe city reported by the contact's last accessed ip address. This is automatically set by gist and can be used for segmentation and reporting
Most Recent CountryThe country reported by the contact's last accessed ip address. This is automatically set by gist and can be used for segmentation and reporting
Number of Unique Forms SubmittedThe number of different gist forms, pop-up forms, and collected forms the contact has submitted
Recent ConversionThe last form the contact has submitted
Recent Conversion DateThe date the contact last submitted a form
Last Meeting Booked DateThe date of the last meeting booked with the contact through a meeting link
First Conversation DateThe date when you first chatted with the contact. This is automatically set by gist
Last Conversation DateThe date when you most recently chatted with the contact. This is automatically set by gist


Stripe Properties

Stripe Properties
Property Description
Stripe Account BalanceThe current balance, if any, being stored on the customer’s account
Stripe CurrencyThe three-letter ISO code for the currency the customer can be charged in for recurring billing purpose
Stripe Delinquent StatusIndicates if the latest invoice charge has failed.
Stripe All Subscription NamesA string with a list of all active subscriptions the customer is enrolled to, separated by commas. Will include free plans.
Stripe Subscription ActiveIndicates whether the customer has active subscription to a paid plan or not
Stripe Current MRRThe monthly recurring value of the customer across all active subscriptions
Stripe Card BrandThe brand of the card on file. Can be American Express, Diners Club, Discover, JCB, MasterCard, UnionPay, Visa, or Unknown
Stripe Subscription Cancelled DateThe time when a paid subscription was last cancelled
Stripe Free Trial End DateThe time when the customer’s active free trial ends. If they have two or more active free trials, the one that ends sooner is saved
Stripe Plan NameThe name of the plan. If customer is subscribed to multiple subscriptions, the highest billed subscription is considered.
Stripe Plan PriceThe price of the plan.  If customer is subscribed to multiple subscriptions, the highest billed subscription is considered.
Stripe Plan IntervalThe interval of the plan. If customer is subscribed to multiple subscriptions, the highest billed subscription is considered.
Stripe Subscription Period Start DateThe time when the subscription was created. If customer is subscribed to multiple subscriptions, the highest billed subscription is considered.
Stripe Subscription Last Billed DateThe time when the subscription was last billed. If customer is subscribed to multiple subscriptions, the highest billed subscription is considered.
Stripe Subscription Next Billing DateThe time when the subscription is next billed. If customer is subscribed to multiple subscriptions, the highest billed subscription is considered.







Did this answer your question?