View and explore library analytics
Who can use this feature
Supported on the Organization and Enterprise plan.
Any member of an organization can view library analytics. Members can only see data for libraries they have at least can view access to.
Share libraries in a team or across your entire organization. Track how members of your organization are using libraries and components with design system analytics.
- Find out which components are popular
- Identify often detached components
- See how collaborators are using variants
- Identify under-used components
- Compare adoption between two libraries
- See which teams are using each library
- Find examples of components so you can see how they're used and supplement documentation
Note: Figma only includes libraries a member has at least can view access to in these results. You will not be able to track component usage within another member's Drafts.
View organization libraries
Any member of an organization can view library analytics. It's not possible to give guests access to library analytics.
- Open Figma in the organization workspace.
- Click All teams or All workspaces in the sidebar.
- Select Libraries to see an overview of all libraries.
Tip: Figma updates Library analytics every hour.
From the library modal you can:
- A Use the Search field to find a specific library.
- B View a summary of analytics across all libraries:
- Total teams: The total number of teams in the organization. This includes open, closed, and secret teams.
- Teams with libraries: How many teams in the organization are using shared libraries.
- Total libraries: Total number of libraries in an organization. This includes libraries shared across the entire organization, or within a specific team.
- Total components: The total number of main components across libraries.
- Total styles: The total number of styles across libraries.
- C View a list of all libraries shared within teams or across the organization. Figma will group libraries by team. For each library you can view:
- # of components: The total number of main components in that library.
- # of styles: The total number of styles in that library.
- Used by: The number of teams using this library.
- Inserts last week: The number of times a component from this library was inserted into a file. This is limited to the last week.
- D Select a library view styles and components in that library, along with library analytics.
View analytics for a library
Select a library to view more information. Use the tabs at the top to view an Overview of styles and components or the Library analytics. First, let's clarify a few terms you'll see:
- Component insertions / Inserts: Any time someone adds an instance of a component to a file. Figma records any of the following actions as insertions:
- Copy an instance and paste it into the file
- Duplicate a component instance within a file
- Drag a component from the Assets panel into a file
- Component detaches / Detaches: Any time someone uses Detach instance to break the connection between the instance and the main component. Detach component instances →
- Last modified: The last time a collaborator made a change to that file. This includes any interaction with layers on the canvas, or leaving a comment.
- [Last] week: Refers to the last calendar week and not the last 7 days. The end of the week will depend on your geographical location. For example: North America considers Saturday the last day of the week and Europe considers Sunday the last day of the week.
Overview
In the Overview tab, you can view a summary of information relating to this library.
- A View an overview of analytics for this library:
- Teams using this library: Number of teams using components from this library.
- Total components: total number of main components in that library.
- Total styles: total number of styles in that library.
- Activity this week: The total number of times people have
inserted
components from this library into their files.
- B View any styles in the library. Hover over the style to the view the style name.
- Color styles appear as swatches
- Text styles
- Effect styles
- Layout grid styles
- C View components in the library. Figma groups components by name, then file, page, and frame. Name and organize components →
Library analytics
Figma started tracking Library analytics September 28th, 2019. You won't be able to access any data before this date.
In the Library Analytics tab, view detailed analytics on how members are using components. Styles aren't included in library analytics.
- A Select the Duration to view analytics for. Choose from:
- Last 30 days
- Last 60 days
- Last 90 days
- Last year
- B View a graph of Component insertions for the selected duration. Figma plots the graph to the end of the current week.
- Current data is blue
- Unavailable data is grey
- Dashed line shows this week's current usage (incomplete)
- Hover over the dot to view the date and total number of component insertions
Tip: You can also compare performance between libraries. Compare analytics between libraries ↓
- C View the teams that are using this library:
- The top teams by total number of insertions.
- Percentage of total component insertions each team contributes
- How many other teams are using this library
Note: If there are more than five teams using a library, click Download CSV to download a CSV file. Download team usage ↓ - D View Components statistics for each component in the library. Both inserts and detaches are for the duration you set above.
- Thumbnail of the component
- Variants in the component set
- Component name
- Inserts
- Detaches
- E Click on the component in the list to see metrics for individual variants within that component set.
Download team usage
If you have more than five teams using a library, you can download a CSV of component usage. The CSV download includes the following analytics:
- Team ID: The unique ID Figma uses to identify the team.
- Team Name: The name of the team as it appears in your Organization.
- Insertions: The total number of component Insertions made in each team.
- Insertion %: A team's percentage of total component insertions. Use this to see how teams contribute to component insertions.
If you have less than five teams using a library, you can view this information in the Top teams section. If you want to export this data, you can copy and paste this into a spreadsheet/document.
View variant and component usage
Click on a component in the Components analytics section to see how specific components are being used with component analytics.
- A View information about the component set:
- Description: a description of this component set. You can add a description to the component set, as well as any variants in that component set.
- Total: Total number of instances of any variants in this component set.
- Used by: Total number of teams that use variants from this component set.
- Used in: Number of files that use instances of this component set.
- B View a list of variants included in that component set. You'll see some analytics for:
- Instances (total): How many instances of that variant exist in files.
- Detaches (last 30 days): How many times someone has detached that variant from the component set in the last 30 days.
- C Select a variant in the list to view analytics for that specific variant.
Figma will show those same statistics, for that specific variant. You can also view a list of files that variant was used in for that reporting period. You'll only see files you have access to.
Note: Figma will only show files you have at least can view access to. This includes files from your Drafts, teams that you are a member of, and open teams.
Compare libraries
Compare analytics between two libraries to:
- Track adoption of a new library (For example: compare a new vs legacy design system)
- Compare how libraries are used across different operating systems
- Measure work between products or brands
From the Library tab of the organization.
- Select one of the libraries you want to compare.
- Open the Library analytics tab.
- Click Compare insertions to and select the second library.
- Figma will plot the graph for both libraries
- Data for the original library is in blue
- Data for the second library is in black
- Unavailable data is grey
- Dashed line shows this week's current usage (incomplete)
- Hover over a dot to view the date and total number of component insertions.