# Merging libraries

**URL:** https://community.penpot.app/t/merging-libraries/10730
**Category:** Ask the community
**Created:** [July 17, 2026, 2:06pm UTC](https://community.penpot.app/t/merging-libraries/10730 "2026-07-17T14:06:57Z")
**Posts on this page:** 5
**Page:** 1

<div class="post-metadata">

### Author: ![Ricardo\_Harano\_Pinto](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/ricardo_harano_pinto/32/10821_2.png) [@Ricardo\_Harano\_Pinto](https://community.penpot.app/u/Ricardo_Harano_Pinto)
#### Post date: [July 17, 2026, 2:06pm UTC](https://community.penpot.app/t/merging-libraries/10730/1 "2026-07-17T14:06:57Z")

</div>

I wanted to export the carbon design system to penpot, so I exported page by page of the carbon design system to penpot. I could not export the whole project. And now I want to merge all those pages in one library but i am not getting it. Any ideas how I can do it?

---

<div class="post-metadata">

### Author: ![LauraKalbag](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/laurakalbag/32/5014_2.png) [@LauraKalbag](https://community.penpot.app/u/LauraKalbag)
#### Post date: [August 5, 2026, 3:43pm UTC](https://community.penpot.app/t/merging-libraries/10730/2 "2026-08-05T15:43:58Z")

</div>

@Ricardo_Harano_Pinto I’m not sure if I entirely understand what you’re trying to do. Are you saying that you have multiple Penpot files each containing a page of the Carbon design system that you want to merge into one file with multiple pages? Could you copy paste the pages into one file to create the library?

I’m sure we can find a way to do what you need!

---

<div class="post-metadata">

### Author: ![girafic](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/girafic/32/11061_2.png) [@girafic](https://community.penpot.app/u/girafic)
#### Post date: [August 6, 2026, 11:10am UTC](https://community.penpot.app/t/merging-libraries/10730/3 "2026-08-06T11:10:06Z")

</div>

@LauraKalbag I think what’s happening here is that Ricardo is trying to move the Carbon design system from Figma to Penpot using the Penpot Exporter plugin. The file is simply too large, so the export aborts and never finishes.

That’s why he ended up exporting page by page as separate .penpot files — and now has the problem of merging them back into a single library.

---

<div class="post-metadata">

### Author: ![girafic](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/girafic/32/11061_2.png) [@girafic](https://community.penpot.app/u/girafic)
#### Post date: [August 7, 2026, 11:12am UTC](https://community.penpot.app/t/merging-libraries/10730/4 "2026-08-07T11:12:08Z")

</div>

@Ricardo_Harano_Pinto Vibe-coded a tool for exactly this use case, merging multiple `.penpot` exports into one library file: [GitHub - girafic/penpot-file-merger: Merges several `.penpot` exports into a single library file, on the ZIP level — no Penpot instance, no plugin API, no browser. · GitHub](https://github.com/girafic/penpot-file-merger)

Inside Penpot there’s no way to combine the files (the plugin API can’t move content between files, and copy-paste loses component links and tokens), so the tool works directly on the `.penpot` ZIP archives instead. Components (including variant sets), colors, typographies and design tokens all survive the merge. I tested it with your exact scenario: the full Carbon Design System merged from 4 Figma exports — 29 pages, ~170k shapes, 2,417 components and 7,140 design tokens — imports fine into penpot.app.

Also, since exporting page by page is painful: I’ve opened a PR for the Figma exporter plugin that adds a “Choose pages” export scope, so you can export several pages per file in one go: [Feature page selection for export by girafic · Pull Request #403 · penpot/penpot-exporter-figma-plugin · GitHub](https://github.com/penpot/penpot-exporter-figma-plugin/pull/403)

One heads-up for large files (100 MB+): Penpot’s import dialog may show **“Something went wrong while processing this file”** even though the import actually succeeds — the progress stream times out while the backend keeps working. Check your drafts before retrying; the file is usually there, complete.

Hope that helps!

---

<div class="post-metadata">

### Author: ![a-ng-d](https://dub1.discourse-cdn.com/flex017/user_avatar/community.penpot.app/a-ng-d/32/11021_2.png) [@a-ng-d](https://community.penpot.app/u/a-ng-d)
#### Post date: [August 13, 2026, 5:19pm UTC](https://community.penpot.app/t/merging-libraries/10730/5 "2026-08-13T17:19:06Z")

</div>

Ah, this is the perfect thread for me because I was exporting a large library, piece by piece, to import it into Penpot. The actual process of exporting with the plugin and importing via a `.penpot` file is not a piece of cake, and some links can break.

Interesting contribution, @girafic! It would be helpful to avoid the page that contains an incompatible layer, which causes an exception and makes the scan fail.

I am wondering whether the MCP server can handle this specific use case, that is, how to migrate large libraries from Figma to Penpot.
