The User Composition chart: View your users by the properties they have in common

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.  

Before you begin

First and foremost, events will not appear in any Amplitude charts until instrumentation is complete, so make sure you've got that done. You'll definitely want to read our article on building charts in Amplitude, as this is where you'll learn the basics of Amplitude's user interface. You should also familiarize yourself with our helpful list of Amplitude definitions, and be sure you understand the difference between user properties and event properties. 

Set up a user composition analysis

Most Amplitude charts rely on the Events Module to build an analysis. The User Composition chart is not an event-driven analysis—and, therefore, does not have an Events Module—so it works a little differently.

Instead of events, a user composition analysis relies on user properties. Select a user property you're interested in, define your user segments, and the User Composition chart will display a breakdown of values for that property across the user segments you've specified.

In the example above, we're looking at a comparison of your product's users in the United States and Germany, broken out by the most recent value for the number of communities they've joined.

To build your own user composition analysis, follow these steps:

1. In the Composition Module (where you'd ordinarily find an Events Module), select the user property you're interested in.
2. In the Segment By Module, identify the user segment you want to include in this analysis. You can import a previously-saved segment by clicking Saved and selecting the one you want from the list. Otherwise, Amplitude begins from the assumption that your analysis will target all users.
   
3. If you do not want to import a previously-saved user segment, you can start building your own by adding properties. To do so, click + Filter by, choose the property you want to include, and specify the property value you’re interested in.
4. You can narrow your focus even further by telling Amplitude you only want to include users who have already performed certain actions. To do so, click + Performed, then choose the event you’re interested in.
5. If desired, add another user segment by clicking + Add Segment, and repeating steps 3 and 4.
6. Use the date picker to specify the timezone and set the timeframe of your analysis.
7. In the Measured As Module, specify the user property values you're most interested in seeing:
   

• • Most Recent Value will only consider your users' most recent values of that property. This value will be drawn from a user's most recent active event. For example, users contained in the San Francisco bucket below are those who most recently had that value for the '[Amplitude] City' user property when they performed their most recent active event:
    
    Users may only appear in one bucket when Most Recent Value is selected.
    
    
  • All Values will include every value your active users have had for the property in question during the time frame of your analysis. Remember that the User Composition chart only includes active users, so user property values tied to inactive events will not be returned. For example, in the chart above, any users who fired an Amplitude-instrumented event from San Francisco and New York in the past 30 days would be included in both buckets.
    
    
  • Cross Property Values will show sets of properties that active users have had within the time range selected. These buckets are mutually exclusive; users can only fall into one bucket. The chart below shows that most users are using this product on a single platform only:
    
    
    

In all cases, Amplitude will break out the top 13 values for your user property; any 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; it includes only the users who are part of the top 100 user property value groups by user count.

You can also view your results as a bar graph:

And of course, you can always inspect the composition of your user groups via the Microscope.

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 field at the bottom of the table is the same as the sum in the center of the chart.

You can also export the table as a .CSV file by clicking Export CSV. 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.