Publish a library to share common design elements—like buttons, icons, pieces of UI, colors, or values for certain properties—with the rest of your team. Other people can use these design elements in their files, which helps everyone stay consistent.

When you first create a style, component, or variable in a file, it is only accessible from that file. To make it available in other files, you need to publish it as a library.

If you make changes to these assets or add new ones, you can publish them as updates to the library. People using the library in their files can quickly review the changes and automatically update their designs.

Publish a library

To publish a design file as a library, there needs to be at least one component, style, or variable in the file. If the file is in your drafts, you’ll need to move it to a project before publishing.

Once published, anyone with access to the library’s source file can use the library in their files.

1. In a file with components, styles, or variables you’d like to share, select the Assets tab in the left sidebar.
2. Click the  Libraries icon. The tooltip may read Review library updates if there are updates to libraries you are using in the file, or Review unpublished changes if you have unpublished updates in your file.
3. From the This file section, find your current file and click Publish.
4. Add a description of the library's purpose, or a summary of any decisions or changes.
5. From the list of styles, components, or variables that have been added, modified, or removed, uncheck any assets you don't want to publish. You can also uncheck Changes to deselect everything.
6. Organization and Enterprise plans only: Use the dropdown menu to choose where to publish the library.
7. Click Publish. A notification will appear confirming your library has been successfully published.

Choose where to publish a library Organization and Enterprise

Organization or Enterprise plan users can publish libraries to a specific team or the whole organization. Enterprise plan users can also publish libraries to workspaces.

This helps libraries reach the right audience. For example, you might publish a company-wide design system library to the organization, or a library with mobile app components to the specific team working on the mobile app.

If the library’s source file has sharing permissions that are too restrictive, Figma will prompt you to change them. For example, if your file is set to Only invited people can access and you want to publish a library to the organization, you’ll be asked to change the file’s permissions to Everyone at your organization can access.

Publish updates to a library

If you make changes to a style, component, or variable in a library’s source file, those changes will only appear in the current file until you publish them. Publishing updates to a library follows the same process as publishing a library for the first time.