# Upload a website

> Put a finished website online from a folder or ZIP file, without GitHub. What to upload, the limits, how a new version works and what the refusals mean.

Web page: https://blitz.cloud/docs/upload-a-website/
Updated: 2026-11-13

A finished website, meaning HTML, CSS, JavaScript and images, goes online from your browser. You don't need GitHub or Docker. This page says what to upload, where the limits are and how to replace the site later. Prices and data location are on the [HTML hosting](https://blitz.cloud/html-hosting/) page.

## Put it online

1. In the [dashboard](https://dashboard.blitz.cloud/), click "Put an app online" and choose "Upload a website".
2. Click "Choose a folder" or "Choose a ZIP file". You can also drop either one onto the page. A folder is packed in your browser before it is sent.
3. Give the site a name. The name becomes part of the address: `portfolio` is online at `https://portfolio.yourname.prod.page`.

The files are checked, built into the site and started. The page shows each step and ends with the link.

## What to upload

Upload the finished site, the files a browser can open directly.

- The start page has to be called `index.html`.
- From a project built with Vite, Astro, Hugo or a similar tool, upload the output folder, not the project. It is usually called `dist`, `build`, `out`, `public` or `_site`.
- If the ZIP file has the site in a subfolder, we find it: the `index.html` closest to the top is the start page, and folders called `dist` or `build` come first.
- If two folders on the same level both have a start page, the upload is refused. Upload only the folder of the site you want online.

## Limits

| | Limit |
|---|---|
| ZIP file, or folder once packed | 50 MB |
| Unpacked | 200 MB |
| Files | 5000 |

Large videos and downloads don't belong in the upload. Host them elsewhere and link to them.

## How the site is served

- Only files are served. Nothing in the upload runs on our servers, so PHP or a `server.js` is not executed.
- A site with pages of its own answers a missing page with your `404.html` if there is one.
- A site that is one `index.html` with scripts, as React, Vue and Svelte apps are, gets every unknown path answered with `index.html`. Links deep into the app keep working after a reload.
- An uploaded website is an app like any other: it counts as one of your plan's apps, sleeps on the free plan after 15 minutes without a visit, and can carry your own domain as a Pro app or on Pro. See [Limits](https://blitz.cloud/docs/limits/).

## Upload a new version

Open the website in the dashboard, go to Settings and click "Upload new version". The version that is online stays until the new one is ready. The address doesn't change, and the upload shows in Activity like a push does for code.

We keep the uploaded files for one day. The website itself stays online for as long as you like, but building an old version again after that day asks you to upload it again. Keep your own copy.

## When an upload is refused

| The page says | What to do |
|---|---|
| There is no index.html in it | Rename the start page to `index.html`, or choose the output folder instead of the project |
| There is more than one start page in it | Upload only the folder of the site you want online |
| That is more than 5000 files | You probably chose the whole project with `node_modules`. Choose the output folder |
| That is more than 50 MB | Leave out large videos or downloads |
| A name in the ZIP file points outside its folder | Pack the folder again with your computer's own ZIP tool |
| We can't read that as a ZIP file | Pack the folder again and upload the new file |

## If the site needs more than files

A project that runs code on a server, needs a database or should rebuild on every push goes online from GitHub. See [Deploy a GitHub project](https://blitz.cloud/docs/deploy-from-github/).
