Manage a library for a workspace or organization – Figma Learn - Help Center

Who can use this feature

Available on Organization and Enterprise plans

Organization admins and workspace admins

default-libraries-org-ent-no-workspaces (1).png

As an organization scales, it can have tens, hundreds, or even thousands of published libraries available. Figma has three different ways organization and workspace admins can help people surface and use the best libraries for their work:

Approve a library (Enterprise plan only)
Enable a library by default for a workspace or organization
Set a default variable mode for a library (Enterprise plan only)

What’s the difference between approving a library and enabling a library by default?

Approving a library adds a check mark next to the library name so people can use its components, styles, and variables with confidence.
Enabling a library by default for an organization or workspace adds the library to files by default, making it easier to access.

You might choose to combine these features, or just use one. For example:

The marketing team has a library of client logos that have been officially approved for company use, so they mark the library as approved. Since most teams don’t need to use it in their day-to-day work, they don't enable it by default.
The company is doing a brand overhaul and plans to launch a new design system. Many teams have already started designing with the new system, but it changes frequently. The library is enabled by default so designers can start exploring it in their designs, but with the understanding that it is not yet approved for production use.

Approve a library

Enterprise

Screenshot of a Figma file focusing on the 'Assets' panel. A tooltip reading 'Approved by Twigma admin' appears above a checkmark next to the 'Twigma Core' library, indicating it has been approved.

Approving a library for a workspace or organization lets everyone know that the library has been recommended by an admin. This helps people feel more comfortable choosing which components, styles, and variables to use in their designs.

When a library is approved, everyone sees a check mark next to the library name wherever it appears in design files—like the assets panel or quick inserts—or in Admin. Approved libraries are also pinned to the top of the list of available libraries in files.

Note: When a library gets approved for a workspace, everyone can see an approved check mark next to the library's name in all the workspace's files, even if they're not assigned to that workspace. In draft files, the approved libraries will only show as approved for the workspace someone is assigned to, since drafts don't belong to any workspaces.

Approve or unapprove a library

From the file browser, click Admin in the left sidebar.
If required, click the current workspace name and switch to the correct workspace.
Select the Libraries tab.
Search for—or navigate to—the library you’d like to approve or unapprove and click it.
In the Manage this library modal, click the toggle next to Set as approved library.

From the file browser, click Admin in the left sidebar.
Select the Resources tab.
Search for—or navigate to—the library you’d like to approve or unapprove and click it.
In the Manage this library modal, click the toggle next to Set as approved library.

Note: A workspace admin won’t be able to unapprove a library that’s been approved at the organization level.

Enable a library by default for a workspace or organization

On the Organization and Enterprise plans, organization admins can enable any published library by default for all files in the organization. Team admins can also enable libraries they have access to for teams they manage.
On the Enterprise plan, organization and workspace admins can enable libraries by default for all files in a workspace.

Enabling a library by default helps people access a library’s components and styles in their Figma design and FigJam files, without having to manually search for and add the library.

Organization and workspace admins can enable a library by default for an organization or specific workspaces by selecting one of the following:

Off: The library is not a default library. A library with this option applied can still be enabled by default for individual teams.
All files: Enables the library by default for both Figma Design and FigJam files in the organization or workspace.
Design files: Enables the library by default only for Figma Design files in the organization or workspace.
FigJam files: Enables the library by default only for FigJam files in the organization or workspace.

Note: Other admins can override the default libraries and default variable modes for any workspaces or teams they manage. For example, if an organization admin enables a library by default for all files in an organization, a team admin can modify this setting for teams they manage. Whenever a lower-level admin overrides these settings for an approved library, higher-level admins get an in-app notification notifying them of the change.

Enable or disable a default library

From the file browser, click Admin.
Select the Libraries tab.
Navigate to, or search for, the library you want to manage and click it.
If required, select the workspace you want to enable the library for.
Choose one of the options: Off, All files, Design files, or FigJam files.

From the file browser, click Admin.
Select the Resources page and then the Libraries tab.
Navigate to, or search for, the library you want to manage and click it.
If required, select the workspace you want to enable the library for.
Choose one of the options: Off, All files, Design files, or FigJam files.

Caution: The Libraries tab contains a list of all the libraries you have access to in the organization.

You can enable any library in the list as a default for the organization. This includes libraries where access may be restricted, such as those in closed or secret teams.

If the library file isn’t shared with everyone in the organization, you’ll see the following warning:

If you enable the library by default, Figma will publish the library to the organization and modify the permissions on the file for you.

Note: You can update this setting at any time. Changing the setting does not affect anyone’s ability to manually access the library. If you want to remove access to a library, you can unpublish it.

Set a default variable mode for a library

Enterprise

If a library contains a variable collection with at least two modes, you can also set a default mode for the library.

For example, you might have a variable collection that contains spacing values for different screen sizes. The variable collection might have three modes: desktop, tablet, and mobile.

If your workspace is dedicated to mobile apps, you could set the default mode to mobile. When someone creates a new file in the workspace, the page-level default mode is set to mobile and applies to all variables used on the page. People can always switch to another mode if they need to.

···

Approve a library

Approve or unapprove a library

Enable a library by default for a workspace or organization

Enable or disable a default library

Set a default variable mode for a library