- Hyperclay
- Docs
- Workspace
- Import and export
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.
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:
- Navigate to the folder where you want the imported files placed.
- Open the New menu and click Import files….
- In the Import files dialog, click Choose files… and pick one or more
.html,.htm,.htmlclay, or.zipfiles 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.zipfile 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
.zipof 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) intouploads/import-<folder-name>/, and rewrites relative links across your pages to point to the imported documents and uploads. System files such as__MACOSXand.DS_Storeare skipped.
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), 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 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:
- Open Account menu (My account).
- 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.txtdescribing the archive layout.- Every folder and every document owned by the workspace (including private documents), saved as
.htmlfiles 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, comments, 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 and Export as zip in Hyperclay Local.