Related Videos

• Getting Started with Team Library

  Before you Start

  Who can use this feature

  Users on Any 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?

  1. You create the Styles and Master Components that define your brand.
  2. You publish these Styles and  Master Components to the Team Library. 
  3. 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.
  4. You can continue to develop, Iterate and refine your Styles and Master Components, publishing your changes to the Team Library. We keep a record of your changes in a detailed Version History.
  5. 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

  1. Publishing Components and Styles to Team Library
  2. Accepting Updates from your Team Library
  3. Enabling and Disabling Team Libraries
  4. 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 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: Enabling and Disabling Libraries. 

  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: Removing Files and Component 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 Master Components to other Files?

  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.

  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 Master Style into this File from the options.
• 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.
     1. View the File Name
     2. See how many Styles and Components are in the Library
     3. Click on the Library to view Styles and Components
     4. Click the toggle to Enable or Disable the File
  5. Click the x 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.

• Publish Components and Styles to your Team Library

  Before you Start

  Who can use this feature

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

  Users with Edit access to a File can publish Components and Styles

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

  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.

  • Publish Styles on any Team plan.
  • Use Components from a published Library on Professional teams, Education teams or Organizations. 
  • It's not possible to publish Components on a Starter Team. You can still create and use Components, but you can only access them within the current File.

  Open the Library modal

  If you have a File containing a number Styles or Components you want to reuse, you can publish them to your Team from the Library modal.

  You can open the Library modal a few ways:

  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:

  Assets Tab

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

  1. Click on the Assets tab in the Layers Panel.
  2. Click on the Team Library icon on the right of the Panel: 

  Keyboard Shortcut

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

  • MacOS: Option 3
  • Windows: Alt 3

  Publish Styles and Components

  The Publishing process 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.

  1. Open the Library modal.
  2. Click the Publish button next to the Current file:
     
  3. Add a Description of changes in the field provided: 
  4. You have a few options:
     • To publish all Styles and Components, click Publish.
     •  To review the Styles & Components, click the arrow next to the Styles & Components heading: 
     • To remove any Styles or Components from the published File, right-click on the Style or Component and click Remove from 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.
  5. When you've finalized your Styles and Components, click the Publish button. Figma will show a  notification to confirm your File has been successfully published:.

  Publish updates

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

  Figma will let you know if there are any updates to Styles or Components which need to be published:

  • Show a blue dot on the Team Library icon in the Assets Panel.
  • Show a toast notification with a prompt to Publish changes to your team library.

  1. Click the Team Library icon to open the Library modal.
  2. Next to the Current File you will see a blue button that prompts you to Publish changes:
  3. Clicking this will open the Publishing modal. From here you can add a description and review any changes, before you click Publish:

  Create 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.

  Create Private Components at any step of the publishing process.

  Add a modifier to the Component name

  To prevent Figma from publishing your Components, you can add a prefix or modifier to the Component.

  The publishing modal will skip over any Components using this modifier and exclude them from  the Publishing process.

  Figma will list these Components in the Private to this File section in both the Assets panel and the Publish library modal.

  

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

  If you want to publish these Components, you will need to remove the "." or "_" and publish the Components individually.

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

  Remove Components from the publishing modal

  Remove Components and Styles from your Team Library, during the publishing process.

  1. Open the Publishing modal.
  2. Click the arrow next to Styles and Components to view a list of included Styles and Components.
  3. Right-click on the Style/Component in the list.
  4. Select Remove from library.

  Remove Components from the Assets Panel

  You can also remove a Component that has already been published.

  1. Open up the Assets tab in the Layers Panel using  the Keyboard Shortcuts:
     • MacOS: Option 2
     • Windows: Alt 2
  2. Search for the Component you'd like to remove.
  3. Right-click on the Component and select Remove from Library.
  4. You'll be prompted to publish your changes to the library.

  Publish other 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.

  The fastest way to do this is via the Assets tab.

  1. Click on the Assets tab in the Layers Panel.
  2. The Private to this File section will show any Components they haven't been published.
  3. Right-click on the Component and select Add to Library.
  4. Figma will notify you that your updates are successfully published.

  Tip! Use the Keyboard Shortcuts to open the Assets tab:

  • MacOS: Option 2
  • Windows: Alt 2
• 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:
     • MacOS: 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 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 Master 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:
     • MacOS: 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 Master 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 their Master 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 Libraries

  Before you Start

  Who can use this feature

  Users on Any Plan

  Anyone can leave a File they have been added to

  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 to remove it completely.

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

  Locate the File

  Open the File a Component lives in using the  Go to Master 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 Master Component link:
     
     
  4. Figma will open the File where the Master Component lives.

  Assets Panel

  1. Right-click on the Component in the Assets Panel.
  2. Select Go to Master Component:
  3. Figma will open the File where the Master 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 Master Component link to access the File.

  Leave the File

  1. Open the File where the Master Component(s) 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 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.