Guides
Export and import
Export your site as a .nertia.json file, start a new site from one, replace a site with one, or start from an existing website. For anyone moving, backing up or editing a site outside the browser.
Needs Free · 5 minutes
Before you start
- A site you want to move, back up or edit outside the browser. If you have no site yet, start with Create a site.
- Everything here is on the free plan. A new site from a file counts toward your plan's site limit.
- To export from Claude instead of the app, add the nertia connector in Claude.
1. Get the site file
A nertia site exports as one file, {slug}.nertia.json. It holds the content, the design system and the structure.

Open the site and pick Settings. Under Export, press Export site. Your browser downloads {slug}.nertia.json, and beside it {slug}.v1.json, the full site record.
Anyone who can see the site in your account can export it. If the export is refused, a message says why and nothing downloads.
| Field | What it holds |
|---|---|
version | The format version |
slug | The site's address |
compositionId | The layout |
sections | Every section, in order, with its settings |
copy | Every piece of text, keyed by where it lives |
skinId | The design system |
ds | Token overrides on top of it |
The file does not carry media files, messages from forms, social connections, your domain, products or posts.
The same file works outside nertia as the source for your own code. Scaffold a project from it, and the file becomes the project's site.json:
npm create nersh@latest my-site -- --site ./my-site.nertia.json
Only some sections come along as code. Widget sections currently run only on nertia hosting, so a site that uses them does not move whole.
Code Embed comes along: the file holds each block's HTML, CSS and JavaScript, and a scaffolded project runs them in the same sealed frame. See Code Embed in an exported site.
2. Start a new site from a file
On New site, press + beside the prompt box, choose .nertia.json and pick the file. Then press Build.

nertia makes a new site from the file with a fresh temporary address. The original is untouched, and you pick the real address on first publish. Add a prompt or links as well and the first build works them in.
Older style values the editor no longer supports are left out. The chat lists them, for example "Imported with 1 style value dropped".
Code Embed code is left out of an import: each block comes in with its settings and fallback, and with no code. The chat says "Code Embed code was left out. Add it again in the code editor." See Code Embed in an exported site.
The picker takes .json files only. Anything else says "A site export is a .nertia.json file."
3. Replace a site with a file
Open the site in the editor and press + in the Chat tab. Choose Import project file and pick the file.

nertia asks Replace this site? and swaps every section and all of its content for the file's. There is no merge. After you press Replace, you land in that site's editor.
Code Embed code is left out here too. When the file holds some, the question says so with the same line.
The file's slug picks the site, not the editor you opened it from. If your account has no site with that slug, the import stops with "No site ... in your account. Import must match an existing site."
An import that is not valid JSON says "Could not parse the file." One without a sections list says "Invalid nertia export: missing or malformed sections array."
4. Start from a website
Press + on New site and choose Website link. Paste your current site's address into Link, say what it is in What is this?, and press Add, then Build.

The first build reads the page for your text, your colours and your images, and drafts a nertia site from them. Results depend on the source, so read through the draft. A Google Doc or Sheet link in the same menu works the same way. Five links is the most on one build.
Done
Your browser has downloaded {slug}.nertia.json, or nertia has built a new or replaced site from one. Next: see all your sites.
Problems
- The file will not open in nertia. Check the file ends in
.nertia.jsonand was saved as plain JSON, not as a page. - The import names a site you do not have. Import only replaces a site in your account. Start a new site from the file instead, as in step 2.
- Your images are missing after a move. The file holds no media files. Upload them again on the Media tab.
- Your domain or store did not come along. The file does not carry them. Connect the domain and add the products again on the new site.