# Import and export

> Import HTML pages or a Notion export into your workspace, and download a single document or your entire workspace as a zip.

Source: https://hyperclay.com/docs/import-export/

You own every file in your workspace as standard HTML and uploaded assets. You can import standalone HTML files or zip archives such as Notion and Google Docs exports, download individual documents, or export your entire workspace as one zip file.

## Import

To import pages into your workspace:

1. Navigate to the folder where you want the imported files placed.
2. Open the **New** menu and click **Import files…**.
3. In the **Import files** dialog, click **Choose files…** and pick one or more `.html`, `.htm`, `.htmlclay`, or `.zip` files from your computer.

### What you can import

- **HTML files** (`.html`, `.htm`, `.htmlclay`): Each file you pick becomes a document in the current folder. You can select multiple HTML files at once.
- **A Notion export**: In Notion, open a page's `...` menu, choose **Export**, pick **HTML**, and import the `.zip` file Notion downloads. Hyperclay strips Notion's 32-character IDs from page and folder names, turns subpages into folders, places images and attachments into your uploads, and rewrites links so they keep working.
- **A Google Docs export**: In Google Docs, choose **File**, then **Download**, then **Web page (.html, zipped)**, and import the resulting `.zip`.
- **Any `.zip` of HTML pages and assets**: Hyperclay creates a new folder named after the zip file, imports each HTML page as a document, moves non-page files (such as images, PDFs, or spreadsheets) into `uploads/import-<folder-name>/`, and rewrites relative links across your pages to point to the imported documents and uploads. System files such as `__MACOSX` and `.DS_Store` are skipped.

> [!NOTE]
> If a Notion export with subpages produces a zip that holds another zip inside it (**This zip holds another zip. Unzip it once and import the zip inside.**), unzip the outer file once on your computer and import the inner `.zip`.

### Import limits

- **Page size**: Each HTML page can be up to 8 MB before and after link rewriting. In a zip import, pages larger than 8 MB are skipped and listed in the completion notice while the rest of the zip finishes importing.
- **Zip size**: A zip archive must fit within your plan's per-file upload limit (20 MB on Personal, 100 MB on Maker; see [Uploads](https://hyperclay.com/docs/uploads/)), contain at most 2,000 entries, and expand to at most 200 MB uncompressed.
- **Folder depth**: Imported subfolders cannot exceed the 5-level [folder depth](https://hyperclay.com/docs/files/) limit (**This folder is too deep to import into. Choose a folder higher up.**).
- **One zip at a time**: Hyperclay runs one zip import at a time across the whole service. If another import is running, yours is refused with **Another zip import is running. Try again in a minute.**

## Export your workspace

Anyone with view access to a workspace can download the entire workspace as a single zip archive:

1. Open **Account menu** (**My account**).
2. Click **Export workspace**.

Your browser downloads `<username>-hyperclay-<YYYY-MM-DD>.zip`. Only one export can run at a time per workspace; starting another while one is running shows **An export is already running**.

### What is inside the workspace zip

- `README.txt` describing the archive layout.
- Every folder and every document owned by the workspace (including private documents), saved as `.html` files with absolute `/_/uploads/...` links rewritten to local `/_/uploads/...` paths.
- The `uploads/` folder, with every uploaded file you are allowed to open.
- `MISSING.txt`, added only if any listed file had no stored content.

Documents shared with you from another account, items in [Trash](https://hyperclay.com/docs/trash/), comments, [version history](https://hyperclay.com/docs/version-history/), custom domain settings, and account settings are not included in the zip.

## Download a single document

To download one document from the hosted workspace, open its **Actions for** menu in the files table and click **Download**. Hyperclay saves the document as a single file under its own name, with its upload URLs rewritten to full links on your `hyperclay.com` address, so its images and attachments keep loading from anywhere. Pictures added to a private document are the exception: they load only for people who can open that document.

To export a single document together with its attachments bundled as one `.zip` archive, use the desktop apps: see [Export as zip in HTML Clay](https://htmlclay.com/docs/export/) and [Export as zip in Hyperclay Local](https://hyperclaylocal.com/docs/export/).
