Using Team Library

Styles and Components live in the Files they are originally created in. To reuse Styles and Components across your Files and Projects, you can publish them to your Team Library.

Any time you update a Style or Master Component, you can publish those changes to your Team Library. This allows Team members to review those changes and update any affected objects or Instances they are using.

In this article, we'll cover:

  1. Publishing Components and Styles
  2. Accepting Changes and Updates
  3. Enabling Team Libraries
  4. Removing Files and Components from your Library

For more information on structuring and using Team Libraries, check out: Best practices: components, styles, and shared libraries.

You can also check out our most Frequently Asked Questions at the bottom of the page.

Need a Refresh?

Components are UI elements that can be reused across your designs. They help you to create and manage consistent brands or themes across projects.

They can be accessed from the Assets panel in your Files. Learn more about creating and using Components in our Using Components and Instances article.

Styles are sets of properties that can be applied to objects across your Team's designs. You can use Styles to define attributes for Color, Text, Stroke, Background Color, Effects and Layout Grids.

Styles can be found next to the relevant property in the Properties Panel. Learn more about using Styles in our Applying Styles article.

Publishing Components and Styles

Components and Styles will only exist in the File you created them in.

If you want to use them in other Files and Projects, you will need to publish them to your Team Library.

You will need to be on a Professional Team to access and use Components from a published Library. However, you can still publish Components from a Starter Team

You can publish and use Styles on both Starter and Professional Teams.

In this section we will cover:

Publishing an Entire File

If you have a File containing Styles or Components you want to publish to your Team Library, you can publish them all at once from the Publishing modal.

The Publishing modal allows you to:

  • Add a description of your File. This will appear in the File's Version History.
  • Remove Styles and Components you don't want to Publish.
  • Publish Styles and Components to your Team Library.

Tip! If you are a member of an Organization, you can also choose to publish the library to the entire Organization. Check the box next to Allow any member of Organization to access this file, before you click Publish.

You can open the Publishing modal a few ways:

  1. From the File Name
  2. From the Assets Tab
  3. Using the Keyboard Shortcut

From the File Name

When you have nothing selected in the canvas, you can see the File name in the center Toolbar:

  1. Click the arrow next to the File name: 
  2. Choose Publish Styles and Components from the options:

From the Assets Tab

You can also publish Styles and Components from the Team Library modal. This is accessible from the Assets tab in the Layers Panel.

  1. Click on the Assets tab in the Layers Panel or use the Keyboard Shortcuts:
    • MacOS: [Option] + 2
    • Windows: [Alt] + 2
  2. Click on the Team Library icon on the right of the Panel: 
  3. At the top of the page you will see the Current File. Click Publish:

Using the Keyboard Shortcut

You can use the following Keyboard Shortcuts to open the Library modal:

  • MacOS: [Option] + 3
  • Windows: [Alt] + 3

From here, you can click Publish next to the Current File.

You can then complete the rest of the process via the Publishing modal. This allows you to review your Styles and Components before Publishing:

  1. You can add a Description of changes in the field provided: 
  2. To review the Styles & Components, click the arrow next to the Styles & Components heading: 
  3. To remove any Styles or Components from the published File, right-click on the Style/Component and select Remove from Library:
  4. When you're ready, select Publish to publish the File to your Team Library.
  5. A notification will confirm your File has been successfully published: 

Creating Private Components

You may have Components in a File that you don't want to publish.

This could be a Component that's nested within another Component, that doesn't get used on its own. Or, a Component that's not ready to share as it's still a work in progress.

You can create Private Components within a File. You can:

  • Add a period "." to the beginning of the Component's name in the Layers Panel. The Publishing modal will skip these Components when you are publishing a File.
  • Remove the Components from the library when publishing the File. From the Publishing Modal, right-click on the Style/Component and select Remove from Library
  • Unpublish a Component that has already been published. Go to the Assets Tab and find the Component you'd like to remove. Right-click on the Component and select Remove from library

Publishing Updates to your Team Library

Anytime you make a change to a published Style or Component, you will need to publish that change to the Team Library.

  1. A blue dot will appear on the Team Library icon in the Assets Panel to show that you have pending updates:
  2. You can click on this to open the Library modal.
  3. Next to the Current File you will see a blue button that prompts you to Publish changes:
  4. Clicking this will open the Publishing modal. From here you can add a description and review any changes, before you click Publish:

Publishing Missing or Additional Styles and Components

If you are missing some Components from a Published File, or want to add more Styles and Components, you can publish these individually.

  1. Click on the Assets tab in the Layers Panel or use the Keyboard Shortcuts:
    • MacOS: [Option] + 2
    • Windows: [Alt] + 2
  2. Any Components that haven't been published will appear in the Private to this File section: 
  3. For any Components you want to add to your library, right-click on the Component and select Add to Library:
  4. A notification will confirm your File has been successfully published:

Accepting Changes and Updates

We will notify you of any changes made to Master Components or Styles you're using. This allows you to keep your designs up-to-date.

This will appear as a notification in the bottom-right corner of your screen:

As well as a blue dot on the Team Library icon in the Assets Panel:

You'll receive a notification when:

  • New Components or Styles are available from the Team Library.
  • Updates are available for Components or Styles you are using.

You can then choose to Review Updates or Dismiss a Notification.

Note: We won't notify you when removing Components or Style from a Team Library. You will be able to continue using that Style or any Instances, but there will be no further updates applied.

Review Updates

You can review updates and apply those changes to any Instance or Styles you're using.

  1. Click Review from the notification: 
  2. Or, click on the Team Library icon in the Assets Panel: 
  3. Go to the Updates tab in the Library modal: 
  4. You will see a list of Components and Styles that have been updated. You can click Update next to an individual item to accept those changes:
  5. Or, you can click the Update all button in the bottom-right corner of the modal:
  6. Those changes will now be applied to any Styles or Instances you are using.

Dismiss a Notification

You can choose to Dismiss the notification and continue to use the Instances in their current state.

Click Dismiss to hide the notification: 

Things to Note

  • You will be prompted to update each time you open the File.
  • Even though your Instances are no longer up-to-date, they are still connected to their Master Components.
  • You can accept these changes to Team Library at any time by clicking on the Team Library icon. The notification badge will remain there until changes are reviewed and/or accepted.

Enabling Team Libraries

If you are the Team Owner or Admin, you can choose which Libraries are available to other Team members.

This allows Team members to access shared Styles and Components from within any of their Team Files.

Figma adds any libraries you make available via this process, to the Assets tab of every Team File.

  1. Head to the Team Workspace.
  2. In the Team Settings section, click the Enable Libraries link: 
  3. The Library modal will show you a list of any shared Files that include Styles and/or Components.

    You can see the File name, as well as how many Components and Styles included in each File.

    Click on the File name to view a gallery of the included Components and Styles:
  4. Use the toggle to Enable or Disable an individual File: 
  5. Click the x icon to return to the Team Workspace.

Enabling Libraries an Individual Files

Editors can also choose to enable other libraries in the Assets tab. Any libraries they enable are accessible to any Editors on that file with access to that library.

  1. Click the Team Library icon in the Assets Panel: 
  2. The Library modal will open and allow you to view a list of available libraries: 
  3. Toggle to Enable or Disable a specific library:
  4. Click the x icon to return to the canvas: 
  5. Any libraries you have enabled will now be accessible in the Assets tab: 

Note: If someone does not have access to a library, then they will not be able to see that library in the Assets tab. This will not give them access to that File. This is handy if you want Editors with access to that library to use it, without enabling that file for everyone in the Team.


Removing Files and Components from a Team Library

There are many ways to remove or disable Styles, Components, or entire Files from your Team library.

In this section, we will cover:

Removing Styles

You will need to remove published Styles from the Master File.

When you view a Master File with nothing selected, you will be able to see all Local Styles in the Properties Panel:

  1. Locate the Style in the Properties Panel
  2. Right-click on the Style's name and select Delete Style from the options:
  3. Repeat for any other Styles you want to remove.
  4. Publish the changes to your Team Library.

Tip! You can Go to the Master Style from any File with access to the Team Library. This allows you to Edit or Delete a Style from your Library:

  1. Select an object in the canvas that uses that Style.
  2. Click on the Style's name in the Properties Panel:
  3. In the Style pop up, click the Edit icon: 
  4. Click Go to master style to edit to open the Master file:
  5. Click the < arrow to view the list of Local Styles
  6. Right-click on the Style's name in the list and choose Delete Style:

You will also see an option to Move Master Style into this File. This allows you to edit or delete that style without leaving the current File.

Note: Moving a Style removes it from the original File. If you re-publish the original File, the Style would no longer be included.

Removing Components

You can choose to remove Components when you publishing changes to your Team Library. 

For example: You may have Components in your File that you don't want other Collaborators to see. e.g. a Component of an icon or symbol that makes up part of a published Component, but you can't use them alone. Or, you may have Components that are still in progress and you aren't ready to share yet.

You can also remove Components from your Team Library via the Assets panel in the Master File.

  1. Open the Master File where your Components live.
  2. Go to the Assets Panel in the Layers Sidebar and find the Component you'd like to remove.
  3. Right-click on the Component and select Remove from library
  4. This will move the Components to the Private to this file section in the Assets panel.
  5. Publish the changes to your Team Library.

Tip! You can also quickly remove a Component from your Team Library by adding a period "." to the beginning of the Component's name - in the Layers Panel.

Note: You can open the File for any Master Component from any File with access to those Components. Right-click on an Instance of that Component in the canvas and select Go to Master Component.

Removing a File from your Library

If you no longer want to have access to a specific File in your Team Library, then you can remove it.

Disabling a Library will only remove those Components from the Assets Panel. You will also need to leave the File where the Master Components live.

  1. Open the File where the Master Components live.
  2. Click the Share button to open the Sharing modal: 
  3. Find your name in the list of collaborators.
  4. Click on your current access level and select Leave from the options:  

Unpublish a File

If you are the File owner or creator, you may wish to remove your File from the Team Library. To do so, you will need to unpublish the File.

Note: A Team member can still use Instances from an Unpublished library. They will no longer be able to publish or receive updates to those Instances.

  1. Open the File you want to unpublish.
  2. Go to the Assets tab and click on the Team Library icon. Or, use the Keyboard Shortcuts:
    • MacOS: [Option] + [3]
    • Windows: [Ctrl] + [3]
  3. Click the arrow next to the Current File: 
  4. Click the Unpublish button in the bottom-right corner of the modal: 
  5. Click Remove File from Library to confirm: 
  6. We will remove the File from your Team Library. Team Members will no longer be able to receive updates from this File.

Disabling Team Libraries

If you are a Team Owner or Admin, then you can also disable a Team Library for all members of your Team.

This will prevent Team Members from seeing those Styles and Components in the Assets panel. This won't prevent a Team member from then enabling this library on a specific File.

  1. Head to the Team Workspace.
  2. In the Team Settings section, click the Enable Libraries link: 
  3. Use the toggle next to the File name to Disable the File: 
  4. Repeat for any other Files you want to disable.
  5. Click the x icon to return to the Team Workspace.

Frequently Asked Questions

Can I use Team Libraries in a Starter Team?

You can publish and use Styles when in a Starter Team.

You can also publish Components to a Team Library. You will not be able to use Components in other Files until you upgrade to a Professional Team.

Where can I find the Team Library icon?

You can now find the Team Library icon in the Assets Panel of the Left Sidebar. Click the open book icon to open the Library panel: 

Or, open the Library modal using the Keyboard Shortcuts:

  • MacOS: [Option] + [3]
  • Windows: [Ctrl] + [3]

How do I enable Team Libraries for a specific File?

You can enable Team Libraries for everyone in that File from the Library modal.

You can access the Library modal by clicking the Team Library icon in the Assets Panel. Find out more in the Enabling Libraries for Specific Files section.

How do I remove a File from my Team Library?

Disabling a Library will only remove those Components from the Assets Panel. You will also need to leave the File where the Master Components live.

Find out more in the Removing Files from your Library section.

Some of my Components or Files are missing, or out of date

If you have created or updated Components - without publishing any changes - your Team Library may be out of date.

You can find unpublished Components in the "Private to this File" section of the Assets Panel: 

Find out more in the Publishing Components to your Team Library section.

Can I Copy or Move Master Components between Files?

No. It's not possible to move Master Components to a new File. Moving Components breaks the connection between the Master Component and any existing Instances.

Copying a Component from one File to another will create an Instance of that Component. To make this a Master Component, you would need to turn that Instance into a Component. This would be separate to the original Master Component.

You can move Styles between Files without breaking the connection.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.