penpot/docs/user-guide/export-import/export-import-files.njk
andrés gonzález fae248bb35
📚 Update user guide for 2.20 features (#13149)
* 📚 Update user guide for 2.20 features

- WebGL rendering is on by default for new accounts.
- Text copied in Penpot keeps its formatting when pasted.
- Detach reference in typography and shadow token forms.
- Saving: retries and read-only mode while saves fail.
- Version restore message for people who have the file open.
- Esc closes the layer search, history and shortcuts panels.
- Ctrl/Cmd+click opens files and projects in a new tab.
- Import steps and per-file export progress; current export
  option labels, including Link matching libraries on import.

AI-assisted-by: claude-opus-5-5

* 📚 Apply review precisions to the 2.20 user guide

Cancelled imports keep the files that already finished. Pasted text
detaches typographies instead of removing them, and only gets the default
fill when the image was its only fill. Detach reference is a hover icon.
A single match you can't edit also asks for the library.

AI-assisted-by: claude-opus-5-5
2026-11-20 14:16:30 +01:00

87 lines
6.7 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: Export/Import Penpot files
order: 1
desc: Learn how to import and export files in Penpot, the free, open-source design tool. Discover file formats, backups, sharing, and library management.
---
<h1 id="export-import-files">Export and import Penpot files</h1>
<p class="main-paragraph">You can export Penpot files to your computer and import them from your computer to your projects.</p>
<h2 id="files-export">Export Penpot files</h2>
<p>Exporting files is useful for many reasons. Sometimes you want to have a backup of your files and sometimes it is useful to share Penpot files with a user that does not belong to one of your teams, or you want to have a backup of your files outside Penpot, both SaaS (design.penpot.app) or at a self-hosted instance.</p>
<h3>How to export Penpot files</h3>
<h4>Export a single file</h4>
<p>You can download (export) files from the workspace and from the dashboard.</p>
<p>
<strong>From the <a href="/user-guide/first-steps/the-interface/#interface-dashboard">dashboard</a></strong>: Select the download option at the file card menu.
<figure><img src="/img/import-export/export-card.webp" alt="Export penpot file" /></figure>
</p>
<p>
<strong>From the <a href="/user-guide/first-steps/the-interface/#interface-workspace">workspace</a></strong>: Select the download option at the main menu.
<figure><img src="/img/import-export/export-menu.webp" alt="Export penpot file" /></figure>
</p>
<h4>Export multiple files</h4>
<p>Select multiple files to export them at the same time. The export dialog lists each file with its own progress and, once it is ready, its size. Each file downloads as soon as it's ready.</p>
<p>Use <strong>Cancel export</strong> to stop the files that are still exporting. Files that already downloaded are kept.</p>
<figure>
<video title="Export multiple files" muted="" playsinline="" controls="" width="auto" poster="/img/import-export/export-multiple.webp" height="auto">
<source src="/img/import-export/export-multiple.mp4" type="video/mp4">
</video>
</figure>
<h4>Exporting files linked to Shared libraries</h4>
<p>Exported files linked to shared libraries provide different ways to export their assets. Choose the one that suits you better.</p>
<ul>
<li><strong>Export file + libraries</strong>: Files with linked libraries will be included in the export, maintaining their linkage.</li>
<li><strong>Embed library assets in the file</strong>: Files will be exported with all library assets merged into the file library.</li>
<li><strong>Treat assets as basic objects</strong>: Libraries will not be included in the export and no assets will be added to the file library.</li>
<li><strong>Link matching libraries on import</strong>: Libraries are not included in the export. When the file is imported, Penpot links it to the shared libraries of the destination team that have the same names.</li>
</ul>
<figure><img src="/img/import-export/export-libraries.webp" alt="Export penpot file" /></figure>
<h2 id="files-import">Import Penpot files</h2>
<p class="advice">The maximum file import size is currently limited to 1GB.</p>
<p>The import option is at the projects menu. Press “Import files” and then select one or more .penpot files to import. You can import a .zip file as well.</p>
<figure><img src="/img/import-export/import-menu.webp" alt="Import penpot file" /></figure>
<p>Right before importing the files to your project, you’ll still have the opportunity to review the items to be imported, have the information about the ones that can not be imported and also the chance to discard files. Each file shows its size.</p>
<figure><img src="/img/import-export/import-selection.webp" alt="Import penpot file" /></figure>
<p>The import goes through three steps, shown at the top of the dialog:</p>
<ol>
<li><strong>Check</strong>: Penpot makes sure each file can be imported.</li>
<li><strong>Upload</strong>: the files are sent to Penpot, with a progress bar.</li>
<li><strong>Import</strong>: Penpot rebuilds the pages, components and assets in your project. Large files can take several minutes.</li>
</ol>
<p>If you cancel an import, files that are still importing are not added. Files that already finished stay in your project.</p>
<h3 id="import-link-libraries">Link libraries on import</h3>
<p>Files exported with <strong>Link matching libraries on import</strong> are linked to the shared libraries of the destination team that have the same names. When there is exactly one match and you can edit it, Penpot links it automatically. When several libraries match, or the only match is one you can't edit, the dialog asks you to select the library for each file. When there is no match, the file is imported without the link.</p>
<h2 id="penpot-formats">Penpot file format</h2>
<p>Penpot exports to a unique format that streamlines the import and export of files and assets by being more efficient and interoperable.</p>
<p>Unlike other design tools, <strong>Penpot's format is built on standard languages</strong>. The exported file is essentially a ZIP archive containing binary assets (such as bitmap and vector images) alongside a readable JSON structure. By avoiding proprietary formats, Penpot empowers users with autonomy from specific tools while enabling seamless third-party integrations.</p>
<p>For a detailed look at what's inside a .penpot file, see <a href="/user-guide/export-import/penpot-file-format/">The .penpot file format</a>. Developers can also check the <a href="/technical-guide/developer/data-model/penpot-file-format/">technical specification</a>.</p>
<h3>Deprecated Penpot file formats</h3>
<p class="advice">These formats can only be exported from version 2.3 or earlier versions, but can be imported to any Penpot version.</p>
<p>There are two different deprecated Penpot file formats in which you can import/export Penpot files. A standard one and a binary one. You always have the chance to use both for any file.</p>
<h4>[Deprecated] Binary file (.penpot) — v1</h4>
<p>The fast one. Binary Penpot specific.</p>
<ul>
<li>✅ Highly efficient in terms of memory and transfer time when exporting and importing.</li>
<li>❌ It can be opened only in Penpot.</li>
<li>❌ Not transparent, code difficult to explore.</li>
</ul>
<h4>[Deprecated] Standard file (.zip) — v2 (never released)</h4>
<p>The open one. A compressed file that includes SVG and JSON. This format was developed but never released to users.</p>
<ul>
<li>✅ Allows the file to be opened by other softwares (still, for those cases export to SVG seems to be the common practice).</li>
<li>✅ Allows some automations and integrations.</li>
<li>✅ Is a transparent, existing, open standard format.</li>
<li>❌ Highly inefficient in terms of memory and transfer time when exporting and importing (this is because SVG).</li>
</ul>