Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Contact Us
  • Home
  • Installation & Developers
  • Installing Appcues

User Properties Overview

Updated at December 12th, 2022

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Installation & Developers
    Installing Appcues Installing Appcues Mobile API & Data Troubleshooting Extras
  • User Experiences
    Web Experiences Building Web Experiences Building Mobile Experiences Customization & Styling Targeting Studio Troubleshooting Use Cases FAQ
  • Mobile
    Installation & Overview Building Mobile Experiences Mobile Analytics Troubleshooting
  • Account Management
    Subscription Users & Data
  • Analytics
    Experience and Event Analytics Data
  • Best Practices
    Use Cases Pro Tips PLG FAQ
  • Integrations
    Integration Documents Use Cases Resources
  • Post-mortem
    System Incidents
+ More

Table of Contents

What are user properties? Why send user properties to Appcues? How do I send user properties? Where can I see which user properties I’m sending? Which user properties should I send? Required Recommended Additional / Optional Installation plan template How do I remove user properties?

What are user properties?

User properties are attributes you send to Appcues from your product about your users. They are the “adjectives” that describe your users. Examples include things like Name, Email Address, Company, Role, Created Date, etc.

Some user properties, like Browser and Current Page URL, are automatically sent to Appcues. For custom user properties specific to your application, however, you will need to send them to Appcues, yourself.

Why send user properties to Appcues?

One of the powerful features of Appcues is the ability to very specifically target users based on who they are or where they are in their customer lifecycle. For example, you may want to target “new marketing admins”, for which you would need to know “created date”, “role”, and “team”. All of these are user properties you can send to Appcues.

For more on targeting flows to particular users, check out Targeting by User Property and Targeting Flows.

How do I send user properties?

Custom user properties are sent to Appcues when a user is identified. Check out the section on sending user properties in our Installation Overview (for Developers) article for more information.

Where can I see which user properties I’m sending?

All your custom properties will be listed on the Events and Properties page in your Appcues settings. Please note that user properties will only appear on this list after at least one user with this property has been identified in Appcues.

You can also see user properties on a certain page in your app if you open the Appcues Debugger.

Which user properties should I send?

Here’s a set of recommended user properties to start sending first. You can add more later as needed, but (as you probably know) developer time can be hard to come by.

Required

Property Reasoning
User ID The only absolutely required user property, must be present for Appcues to function.

Recommended

Property Reasoning
Created Date (user) For knowing how long a user has been using your product.
Plan Type Example: trial, paid. Used for lifecycle targeting.
Plan Tier Example: standard, enterprise.
Role Example: admin, standard. However you differentiate permissions.
Team Example: marketing, sales. Or any other way you segment your users.
Beta User / Feature Flags To communicate with users who have access to certain features.
Renewal Date To remind users to renew. This is generally an account-level property that is added to each user.

Note: Certain properties (user name, email, etc) are considered personally identifiable information and should be used with caution. Please consult with your security and product teams before implementing any of those properties within Appcues.

For more information on how to Appcues with PII, please read our FAQ for Developers document.

 

Additional / Optional

Property Reasoning
First Name For personalizing content.
Last Name Also for personalizing content.
Email Address Can be used for various identification.
Company Name For personalizing content.
Location Example: state, zip, country, etc (use multiple properties). Target on where your customer lives.
Version If users can be on a different version of your application they may need to see different content.
Language For multi-language applications.

Installation plan template

To make it easy to figure out what user properties (and events!) you want to send to Appcues, we created an installation plan template. If you choose to create an installation plan, you can share it with the developer(s) that will install Appcues so they know exactly what data you need! 

 

How do I remove user properties?

If you reach out to support@appcues.com with a list of user properties that you would like to remove from your Appcues Studio UI, we can remove them for you. Alternately, you can toggle the "Show in Menus" slide next to the user property in the Events section on your Settings page.

Neither of these options will remove the data from Appcues's database, but the properties will no longer be visible in the Studio interface.

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Appcues Installation Overview
  • Welcome and Getting Started
  • Group Properties Overview
  • FAQ: Troubleshooting the Chrome Extension & Builder
Appcues logo

Product

Why Appcues
How it works
Integrations
Security
Pricing
What's new

Use cases

User Onboarding Software
Feature Adoption Software
NPS & Surveys
Announcements
Insights
Mobile Adoption

Company

About
Careers
we're Hiring

Support

Developer Docs
Contact

Resources

The Appcues Blog
Product Adoption Academy
GoodUX
Case studies
Webinar Series
Made with Appcues
Appcues University

Follow us

Facebook iconTwitter icon greyLinkedin iconInstagram icon
© 2022 Appcues. All rights reserved.
SecurityTerms of ServicePrivacy Policy
Expand