View and explore library analytics

Who can use this feature

Available on the Organization and Enterprise plans

Any member of an organization can view library analytics as long as they have can view or can edit access to the library file

Guests don’t have access to library analytics

With library analytics, you can track how your organization uses published libraries and components. Use library analytics to:

• Find out which components and variants are used most
• Identify frequently detached components
• Identify under-used components
• See which teams are using the library
• Compare usage between two libraries
• Find examples of components to see how they're used and improve the documentation for them

View analytics for all libraries in the organization

View analytics for a specific library

1. Open a library file and click anywhere on the canvas to deselect all layers.
2. Click the down arrow next to the file name and select Library analytics.

The Overview tab

The Overview tab includes a summary of information relating to the library.

• A High-level analytics for the library:
  • Teams using the library: Number of teams using components from the library.
  • Total components: Total number of main components in the library.
  • Total styles: Total number of styles in the library.
  • Activity this week: The total number of times people have inserted components from the library into their files. ”This week” refers to the last seven days.
• B Every style in the library.
• C Every component in the library.

The Analytics tab

When you click the Analytics tab at the top of the modal, you can see detailed metrics about how people are using each component and component set within the library.

A few things to note about the data:

• Library analytics don’t track styles.
• Library analytics don’t track component usage within other people’s draft files.
• Nested components won’t count as insertions.
• Figma ignores the initial insertions from duplicating a file.
• Library analytics begin on September 28th, 2019. You won't see data before this date.

• A You can choose to review analytics for the previous 30, 60, or 90 days, or last year (a rolling 12 months).
• B You can compare component insertions between two libraries. This is useful to:
  • Track adoption of a new library or compare between a new and old design system
  • Compare how libraries are used across different operating systems
  • Measure work between products or brands
• C A graph of Component insertions for the selected time period. A component is inserted any time an instance gets added to a file, including when somebody:
  • Copies an instance and pastes it into the file
  • Duplicates a component instance within a file
  • Drags a component from the Assets panel into a file
  • Swaps an instance

  Note: Figma plots the graph to the end of the current week. The end of the week will depend on your geographic location. For example: Figma displays Saturday as the last day of the week in North America and Sunday for people in Europe. You can hover over a dot to view the date and total number of component insertions. The component insertion chart is coded as follows:

  • Current data is blue
  • Unavailable data is grey
  • Comparison data is black
  • A dashed line indicates an incomplete week
• D Teams using the library, including the total number of insertions for each team, as well as each team’s percentage of component insertions relative to the total.

  Note: If there are more than five teams using a library, Download CSV will appear. This gives you the option to export the team data for further review. If there are less than five teams using a library and you want to export the team data, you can copy and paste it from the modal into a spreadsheet or document.

• E Component statistics for each component or component set in the library for the selected time period.

  Note: Figma logs a detach any time someone uses the Detach instance setting to break the connection between the instance and the main component.

• F Click on a component set to View variant usage, or a component to View component usage.

View variant usage

When you click on a component set in the Components statistics section of the Analytics tab, Figma displays information about how each variant in the component set is used.

• A Aggregate information about the component set:
  • Description: A description of the 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 all variants in the component set.
  • Used by: Total number of teams that use variants from the component set.
  • Used in: Number of files that use instances of variants in the component set.
• B A table of variants included in the component set:
  • Instances: The current total number of variant instances in files. This gives you a current snapshot of the component's usage, rather than its historical usage over time.
  • Inserts: The number of times the variant has been inserted into any file in the last 30 days. This includes instances that have since been deleted, and is most useful for understanding historical usage of a component over time.
  • Detaches: The number of times someone has detached the variant instance from the component set in the last 30 days.
• C Click any variant in the list to view analytics for that specific component. See View component usage).

View component usage

• A Aggregate information about the component:
  • Description: A description of the component.
  • Total: Total number of instances of this component in your organization.
  • Used by: Total number of teams that use this component.
  • Used in: Number of files that use instances of this component.
• B A table of files using the component. You can only see component usage for files in teams that are open to anyone in the organization, or in teams set to Only those invited that you have access to.
  • The files where the component or variant is used.
  • The team containing the file where the component or variant is used.
  • The number of instances of the component or variant in the file.
  • When the file was last modified.

Library Analytics API beta

The Library Analytics API, part of the Figma REST API, lets you fetch analytics data about how your organization's design system libraries are being used. The API provides similar information to the in-product library analytics feature, but in a format that you can use to do more fine-grained, custom analysis.

For more information about the Library Analytics API, check out the Figma REST API documentation ->