--- title: Libraries order: 2 desc: Use Penpot's libraries for reusable design elements! Learn to create, manage, and share components, colors, and typography. Try Penpot - it's free! ---

Libraries

Libraries may include components, colors and typographies. Learn how to create and manage them to better organize the pieces of your designs and speed your workflow.

File libraries

Each file has its own file library which is where the assets that belong to this file are stored.

You have two ways to access the file library from the file workspace:

Library assets tab

Shared libraries

Publish as shared library

You can publish any regular file as a shared library. This means that the file library of this file will be available to be connected to other files that exist in the same team, so its library assets can be reused.

There are two ways to publish a library:

Publish library
Publishing a library from the main menu
Publish library
Publishing a library from the libraries panel

Unpublish a shared library

You can unpublish any library anytime the same way you can publish it, both from the file menu and the libraries panel.

Unpublishing a library will disconnect it from the files where it was connected. The assets that have already been used in other files will remain, but no longer linked with the now unpublished library.

Library updates

Update libraries

Connect shared libraries

To add a Shared Library from another file, launch the libraries panel, then search and select the available libraries. If you see the message "There are no Shared Libraries available", start by publishing other files as a shared library or add from our Libraries & templates.

Disconnect shared library

You can disconnect any library anytime from the libraries panel just by clicking on the disconnect button.

Disconnect libraries

Use shared libraries

Shared libraries will be listed at the assets panel, at the workspace left sidebar. You can expand and collapse them to access the assets of each connected shared library.

Connected libraries list

Open shared library file

Click on the arrow icon at the right of a shared library name to go to the file where the library is and edit its contents.

Open libraries

Import tokens from a connected library

If a shared library you have connected includes design tokens, you can copy them into the current file from the Libraries modal.

The Import tokens button appears only next to connected libraries that define tokens. Libraries without tokens do not show this control.

  1. Open the Libraries panel from the assets tab.
  2. Under Libraries in this file, find the connected library that includes tokens and click Import tokens (beside the disconnect control).
  3. Review the confirmation dialog. Importing brings in the library's full token data, including sets and themes when the library defines them.
  4. Click Import tokens to apply, or Cancel to go back without changes.

Importing tokens from a library replaces all tokens, sets and themes in the current file. Export your tokens first (from the Tokens tab → Tools → Export) if you need to keep a backup.

This is separate from connecting the library for components, colors and typographies. You can use shared assets without importing tokens, and import tokens only when you want the file's token setup to match the library.

Import tokens button in the Libraries modal
The Import tokens button on a connected library that includes tokens.
Import tokens from library confirmation dialog
Confirm before importing. All current tokens, sets and themes in this file will be replaced.