Skip to content
swebsy. docs

Static site export

The static export produces a self-contained ZIP archive — one HTML file per page, a compiled stylesheet, and all assets. You can host it on any static server.

The Deploy menu also shows your configured deployment provider when one is set. The export options stay in the same menu, below the deployment actions.

Export your site

Section titled “Export your site”
  1. Click the Deploy menu in the topbar.

  2. Choose Export code (standard) or Export code (minified) (smaller files, harder to read).

  3. A progress modal appears while Swebsy builds your pages and bundles all styles.

  4. A ZIP file downloads when the export completes.
Exporting the site as a ZIP archive

What’s in the ZIP

Section titled “What’s in the ZIP”
site-title/
├── index.html          # homepage
├── about/
│   └── index.html      # additional pages as subfolders
├── assets/
│   ├── style.css       # all your site's styles in one file
│   ├── script.js       # optional custom JS
│   └── ...             # uploaded images and fonts
└── sitemap.xml         # if enabled in Settings → Performance

Optimize images

Section titled “Optimize images”

By default your images are exported exactly as you uploaded them. On a photo-heavy site that is usually 90%+ of the download.

Turn on Settings → Performance & Security → Images to re-encode them during export:

  • Balanced — WebP at quality 80, resized to 2560px on the longest edge. Supported by around 96% of browsers.
  • Smallest — AVIF at quality 55, resized to 2048px. Smaller again, but roughly 5% of visitors use a browser that cannot display AVIF.
  • Custom — pick the format, quality, and maximum dimension yourself.

The setting applies to the ZIP export and to both deploy integrations. The deploy review modal and the export toast report the real before/after bytes.

Only PNG and JPEG images are re-encoded. SVGs, GIFs, and anything already in a compressed format pass through untouched, and an image is never replaced by a larger version of itself.

Nothing is done to your originals — they stay in the project exactly as uploaded, so you can change the preset and export again at any time. If one particular image looks wrong after compression, open it in the asset gallery and turn on Keep original quality.

Two things worth knowing:

  • Re-encoding drops EXIF metadata. That also strips GPS coordinates from photos taken on a phone, which is usually what you want on a public site.
  • Images are converted to sRGB. A Display-P3 or Adobe RGB photo loses its wide gamut.

Host the ZIP

Section titled “Host the ZIP”

Unzip and upload the contents to any static host:

Common issues

Export hangs on large sites — building styles for a large site can take 10–30 seconds. Wait for the progress modal to close before navigating away.

Images missing in the ZIP — only assets that were uploaded via the Swebsy asset manager are bundled. External image URLs (hotlinked) are kept as-is.

Styles look different from the editor — the editor renders styles live; the export bundles them into a static file. If you see differences, try exporting again after saving all changes.