Related Videos

• Get started with Team Library

  Before you Start

  Who can use this feature

  Users on any team or plan can use a Team Library and publish Styles.

  Users on Education, Professional, and Organization plans can publish Components.

  Users with Edit access to a file can publish a 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.

  What is Team Library

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

  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.

  You can use the Team Library to access these resources across your Team files and Projects. This allows you to maintain a consistent brand and style, at scale.

  How does it work?

  • Create the Styles and main Components that define your brand.
  • Publish these Styles and Components to the Team Library. 
  • This allows everyone in your Team to view and use them across their files. Components can be access via the Assets panel, Styles from the Properties Panel.
  • You can continue to develop, iterate and refine your Styles and Components, publishing your changes to the Team Library. We keep a record of your changes in a detailed Version History.
  • Designers and collaborators can quickly update any affected Styles and Components. This ensures they're always up to date and using the latest version.

  Help Articles

  • Publishing Components and Styles to Team Library
  • Accepting Updates from your Team Library
  • Enabling and Disabling Team Libraries
  • Removing files and Components from Team Library

  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 the Library. You will not be able to use Components in other files until you upgrade to a Professional team.

  Where can I find the Library modal?

  Use the Team Library icon in the Assets tab of the left sidebar: 

  Or, open the Library modal using the Keyboard Shortcuts:

  • Mac: ⌥ Option  3
  • Windows: Ctrl + 3

  How do I enable 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: Enabling and Disabling Libraries. 

  How do I remove a file from my Library?

  Disabling a Library will only remove those Components from the Assets Panel. You will also need to leave the file where the Main Component lives.

  Learn more about removing files and Components from your Team Library.

  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 Missing Components to your Team Library section.

  Can I copy or move Styles and Components to other files?

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

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

  You can move Styles between files without breaking the connection. To move a Style from its original location, to your current file:

  1. Click on the Style in the Properties Panel.
  2. Click the Edit icon to view the Style in more detail.
  3. Select Move Main Style into this file from the options.
• Enable Libraries in the Assets panel for a file

  Before you Start

  Who can use this feature

  Users on any plan

  Users with Edit access to a File can enable Team Libraries.

  New to Components? Check out our Getting Started with Components and Getting Started with Team Library articles.

  Enable Libraries for a file

  Editors can also choose to enable other libraries in the Assets tab. 

  Note: Any libraries you enable on Team files will also be made available to other Editors with access to those Libraries.

  1. Open the Assets Panel
  2. Click the Team Library icon.
  3. The Library modal allows you to view a list of available libraries. Every Library corresponds to a File with Styles and Components that you have access to.
     
     1. Use the toggle to Enable or Disable a specific files.
     2. Click on the Library to view the Styles and Components in the File.
     3. Click the icon to return to the canvas.
  4. Figma will display Components from those Libraries in the Assets Panel.

  Note: The Library modal only shows Libraries that you have access to. If someone does not have access to a File, they can't access Components from that File in the Assets panel.

  Disable Libraries in the Assets panel

  Disable a Library to remove it from your Assets panel.

  1. Open the Assets panel.
  2. Click the Team Library icon to open the Library window.
  3. Figma will show the toggle of any enabled libraries as dark grey. Click the left side of the toggle to disable the Library.
  4. Figma will remove the Library from the Assets panel.

  Note: This won't remove the Library from your search results, or prevent you from accessing the Components in that File. To remove a Library completely, you will need to leave the Library File.

• Enable Libraries in the Assets Panel for a Team

  Before you Start

  Who can use this feature

  Users on Education, Professional, and Organization plans

  Only the Team Owner or Admin can choose default Libraries for a Team.

  You can access Components shared via Team Library in the Assets panel.

  Team Owners and Admins can choose which Libraries will show up in the Assets tab, by default. This allows Team members to easily access shared Styles and Components from any Team files.

  1. Click on the Team name in the file Browser to open the Team Page.
  2. In the menubar, go to the Settings tab.
  3. Click the Enable Libraries link.
  4. The Library modal will show a list of any files that you have access to.
     • View the file name
     • See how many Styles and Components are in the Library
     • Click on the Library to view Styles and Components
     • Click the toggle to Enable or Disable the file
  5. Click the ✕ icon to return to the Team Workspace.

  Tip! You can also use the Enable toggle when viewing Styles and Components in a file.

  Want to enable a Library on a specific file? Check out our Enable Libraries for a Specific file article.

• Create Private Components in a Published File

  Before you start

  Who can use this feature

  Users on Education, Professional, and Organization plans can publish Components.

  Users with Edit access to a file can publish files as a Team Library.

  New to Components? Check out our Getting Started with Components and Getting Started with Team Library articles.

  You may have Components in a Library 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 is still a work in progress.

  You can create Private Components at any step of the publishing process.

  Before Publishing: Add a modifier to the Component's Name

  You can ensure your Components are private before you publish your Team Library. Add a modifier to the Component's name in the Layers Panel:

  • Add a period  .  to the beginning of the Component's name.
  • Add an underscore  _  to the beginning of the Component's name.

  If you add a period or underscore after a Component has been published, it will be removed from your library the next time you publish any changes.

  The publishing modal will skip over any Components using this naming structure during the Publishing process. You'll see these Component listed in the Private to this file section.

  Note: If you want to publish these Components, you will need to remove the . or _ and publish the Components individually. Learn more about publishing individual Components in our Publish Changes to the Team Library article.

  

  While Publishing: Remove Components from the Publishing Modal

  You can  remove Components and Styles from your Team Library, during the publishing process.

  From the Publishing modal:

  1. Click the arrow next to Styles and Components to view your Styles and Components.
  2. Right-click on the Style/Component in the list.
  3. Select Remove from library:

  After Publishing: Un-Publish Components

  You can remove a Component that has already been published.

  1. Open up the Assets tab in the Layers Panel. Use the Keyboard Shortcuts:
     • Mac: ⌥ Option - 2
     • Windows: Alt + 2
  2. Find or search for the Component you'd like to remove.
  3. Right-click on the Component and select Remove from Library.
  4. Publish your changes to the library via the prompt.
• Publish a file to a Team Library

  Before you start

  Who can use this feature

  Users on any plan can publish Styles. Only users on Education, Professional, and Organization plans can publish Components.

  Users with Edit access to a file can publish files as a Team Library.

  New to Components? Check out our Getting Started with Components and Getting Started with Team Library articles.

  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.

  You can open the Publishing modal a few ways.

  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:
      

  Tip! If you are a member of an Organization, you can also choose to publish the library to the entire Organization. Learn more in our Publish files to to an Organization article.

• Publish Changes to a Team Library

  Before you start

  Who can use this feature

  Users on Any plan can publish Styles. Only users on Education, Professional, and Organization plans can publish Components.

  Users with Edit access to a file can can make changes to a main Component and publish updates to a Team Library.

  New to Components? Check out our Getting Started with Components and Getting Started with Team Library articles.

  Made a change to Style and Components? Or want to add more Styles and Components to a published file? You'll need to publish your changes to the Team Library.

  Publish Changes made to Components

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

  You can publish changes from a few places.

  Publish Notification

  Figma will display a publish notification when you make a change to a published Component. Click Publish to open the Library window.

  

  Team Library Icon

  A blue dot will appear on the Team Library icon in the Assets Panel to show that you have pending updates.

  1. Open the Assets Panel
  2. Click the Team Library icon to open the Library modal: 
     
     
  3. Next to the Current File, click the Publish changes prompt to open the publishing window.
  4. Add a description and review any changes.
  5. Click Publish to publish your updates to the Library.

  Publishing Additional Styles or Components

  If you have already published a file to your Library, you can also publish additional Styles and Components.

  This is great if you are missing Components, or want to add more Styles and Components to to your Library.

  1. Open on the Assets tab in the Layers Panel. Or, use the keyboard shortcuts:
     • Mac: ⌥ Option - 2
     • Windows: Alt + 2
  2.  In the Private to this file section you will find Components that aren't in your Library.
  3. Right-click on the Component in the list and select Add to Library
  4. A notification will confirm that Figma has published the Component to your Library. 
• Accept Updates from Team Library

  Before you start

  Who can use this feature

  Users on Education, Professional, and Organization, plans can accept any update from a Team Library. Users on a Starter Team plan can only accept Style updates from a library without any Components.

  Users with Edit access to a file can accept updates from a Team Library.

  New to Components? Check out our Getting Started with Components and Getting Started with Team Library articles.

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

  Team Library Notifications

  When a change has been published made to your Team library, you will receive a notification. 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.

  The notification will appear on any files that include those Styles or Components.

  You'll see the notification in the bottom-right corner of your screen. A blue dot will also appear on the  Team Library icon in the Assets Panel:

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

  Note: We won't notify you when you remove Components or Styles from a Team Library. You can continue using that Style or any Instances, but you won't receive any further updates.

  Review Updates

  You can then choose to review any updates. This allows you to apply those changes to any Styles or Components 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.
     1. Click Update next to an individual item to accept those changes.
     2. Click the Update all button in the bottom-right corner of the modal.
  5. We will apply those changes to any Styles or Instances you are using.

  Dismiss a Notification

  You can also choose to Dismiss the notification and continue to use the Instances in their current state.  You can then review and accept any changes at a later date. 

  

  Note: You should also be aware of the following:

  • We will prompt you to update your Styles and Component each time you open an affected file.
  • All Instances will remain connected to the Main Component, even if they are out-of-date.
  • 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 you have reviewed or accepted the changes.
• Remove a file from your Library

  Before you start

  Who can use this feature

  Users on any plan

  Anyone can leave a file they have a role on.

  If you no longer want to have access to a specific file in your Library, you can remove it.You will need to leave the file where the main Component lives to remove it completely.

  If you only disable the Library, Figma will remove those Components from the Assets Panel. You will still see those Components in searches.

  Do you own the file and want to remove it from your Team Library? Check out our Remove a file from your Libraries article.

  Locate the file

  Open the file a Component lives in using the  Go to Main Component link. You can find this in a few places.

  In the Canvas

  1. Select the Component in the Canvas. 
  2. Find the Instance section of the Properties Panel.
  3. Click Go to Main Component link.
  4. Figma will open the file where the Component lives.

  Assets Panel

  1. Right-click on the Component in the Assets Panel.
  2. Select Go to Main Component.
  3. Figma will open the file where the Component lives.

  Note: If you haven't used the Component in your file, you can temporarily add the Component to your file. This will allow you to use the Go to Main Component link to access the file.

  Leave the file

  1. Open the file where the Component lives.
  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 from Team Library

  Before you start

  Who can use this feature

  Users on any plan can publish Styles. Only users on Education, Professional, and Organization plans can publish Components.

  The Team Owner or Team Admin can remove a published Library.

  New to Components? Check out our Getting Started with Components and Getting Started with Team Library articles.

  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.

  1. Open the file you want to remove from Team Library.
  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 on the Current File to view the Library.
  4. Click the Unpublish button.
  5. Click Remove File from Library to confirm.
  6. We will remove the file from your Team Library. Team Members will no longer receive updates from Components in this file.

  Note: A Team member can still use Instances from an Unpublished library. They will no longer receive any updates made to those Instances.

• Remove Styles and Components from a library

  Before you start

  Who can use this feature

  Users on Education, Professional, and Organization plans

  Users with Edit can remove Styles and Components from a Library.

  New to Components? Check out our Getting Started with Components and Getting Started with Team Library articles.

  There are a couple of ways to remove a Style. You can simply remove it from a Library or delete it entirely.

  In this article, we'll cover removing Style and Components from a published Library. To tidy up your design systems you can:

  • Remove unused Styles and Components
  • Remove out-of-date or degraded Components

  Are you a member of an Organization? Design System Analytics allow you to track Component usage, including when Components are detached.

  Remove Styles

  To remove a Style from your Library, you will need to unpublish the Style from Library. You can only remove a style from the original file, where the Style currently lives.

  You can access the original Style from any object that is currently using it:

  1. Select an object in the canvas that uses that Style.
  2. Click on the Style in the right sidebar
  3. Click the to edit the Style.
  4. Click Go to style definition to edit to open the Style in the Library.

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

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

  Remove a Style from a Library

  You can remove a Style from a Library without deleting the Style itself. You can only do this from the original Style, the Style definition.

  1. Open the file where the Style lives.
  2. Deselect anything in the canvas.
  3. Click the next to the file name to open the menu.
  4. Select Publish Styles and Components to open the Library modal.
  5. Click on the Styles and Components header to expand.
  6. Right-click on the Style and select Remove from library.
  7. Repeat for any other Style you want to unpublish.
  8. Click Publish to apply your changes and remove the Styles.

  Delete a Style

  You can view Local Styles in the right sidebar, when you select nothing in the canvas. Click an empty spot in the canvas to deselect.

  To delete a Style entirely:

  1. Find the Style in the Properties Panel.
  2. Right-click on the Style and select Delete Style.
  3. Repeat for any other Styles you want to remove.
  4. Publish the changes to your Team Library.

  Remove Components

  You can remove Components when you publish changes to your Team Library. Or, from a library you have already published. You can only remove Components from the file they originate from.

  1. Open the file where your Component lives.
  2. Open the Assets panel in the Layers panel.
  3. Right-click on the Component in the Layers panel and select Remove from library.
  4. Figma will move the Component(s) to the Private to this file section.
  5. Publish the changes to your Team Library.

  Tip! You can also quickly remove a Component from your Team Library via the Layers Panel. Add a period "." to the beginning of the Component's name. Learn more in our Create Private Components article.

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