What You Will Learn in This Article
The User Composition chart shows the breakdown of active users based on a single user property. This grouped view provides insight into who your users are and what properties they share.
This article will explain the different options of analysis available, definitions of terms, and visualization options.
Before you start reading this article, we recommend that you have a look at the prerequisites list below. The information presented in this list will help you out with both useful information and good to know practices but will also contain links to related topics and Help Centre articles:
- A completed instrumentation and events are necessary for data to appear in the User Composition chart.
- Familiarize yourself with our Helpful Definitions: https://help.amplitude.com/hc/en-us/articles/204620508
- Understand the difference between User Properties vs. Event Properties: https://help.amplitude.com/hc/en-us/articles/115002380567
- Amplitude User Property definitions: https://help.amplitude.com/hc/en-us/articles/215562387
Table of Contents
- Chart Control Panel
- Multiple Segments
- Date Picker
- Breakdown Data Table
- Bar Graph
Chart Control Panel
Use the dropdown menu in the left module of the control panel to select which user property you would like to segment on. We will show the top 13 values broken out and all other values will be grouped in the "other" bucket. The value in the center of the chart is the "Column Sum" value in the Breakdown Data Table; this value encompasses only the users who are part of the top 100 user property value groups by user count.
The right module in the User Composition chart control panel functions analogous to the right panel in an Event Segmentation chart. You can read more about how to compare user segments here. The bottom module allows you to select between "Most Recent Value", "All Values", and "Cross Property Values". See the below sections for more information.
Note: User Composition charts created and/or saved before January 31, 2017 are computed using "All Values".
Most Recent Value
"Most Recent Value" will only take the user's most recent value into account (from the most recent active event) and the chart will represent a mutually exclusive count. For example, users that fall into the 'San Francisco' bucket here are users that most recently had '[Amplitude] City' = 'San Francisco'. In this chart, we are looking at the User Composition of 306k users.
"All Values" will count a user in multiple buckets if they had multiple values for that property (on active events) in the specified time range. For example, if in the last 30 days I was in both San Francisco and Vancouver, then I would show up in both buckets in the following chart. "All Values" will therefore not necessarily be mutually exclusive as users can change property values during the time range selected. The number in the center represents the sum of users in each set.
Cross Property Values
If "Cross Property Values" is selected, this will show sets of properties users have had within the time range selected (on active events). These buckets will be mutually exclusive and users can only fall into one bucket. This is useful to see for example, how users are using your product across different platforms. The following chart shows that most of our users are using our product either on Web only or on Web and iOS.
You can also compare up to 2 different segments side-by-side. To do this, use the "+Segment" button to add another segment. For example, in this chart we are comparing our iOS users to our Android users.
When you are comparing multiple segments, the bar chart visualization can also be useful so that you can compare both segments of users side-by-side.
To change the date range of the data, use the calendar dropdown at the top right corner. Note that if a user changes property values over the selected time frame, the user will be represented in each segment they belonged to during the time period.
You can choose to view the chart as a line chart or as a bar chart via the buttons in the upper right-hand corner of the chart. You can also use the date picker to choose a more specific time range to analyze your data within and can switch between "Last", "Between", and "Since".
Breakdown Data Table
Below the chart is a table of composition data. The top 100 user property values with the highest user count are listed on this table. The "Column Sum" at the bottom of the table is the sum in the center of the chart.
You can also export the table as a CSV file by clicking the "Export CSV" button. The CSV file has a limit of 10,000 rows; this means that you can get the top 10,000 user property values by user count with the CSV.
Clicking on the icon allows you to create a bar graph of the data over the selected time frame. As seen below, there were a total of 178,870 users that performed an active event in the United States over the last 30 days.