> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Quick Start by Uploading Your Site

## Article: Quick Start by Uploading Your Site

## Article Link: https://dev.wix.com/docs/go-headless/get-started/quick-starts/wix-managed-headless/quick-start-by-uploading-your-site.md

## Article Content:

# Quick Start by Uploading Your Site

Upload a static site you already built and deploy it as a Wix-managed headless project. Wix hosts and runs your site and connects it to Wix business solutions. There's nothing to install and no terminal required.

Your site gets:

- Managed hosting on a global CDN with automatic SSL.
- A management dashboard for your business data.
- Access to Wix's robust business APIs.

For more information, see [About Wix-Managed Headless](https://dev.wix.com/docs/go-headless/wix-managed-headless/about-wix-managed-headless.md).

> **Note:** Uploading deploys static files only. To deploy a backend alongside your frontend, follow [Quick Start from Your Own Frontend](https://dev.wix.com/docs/go-headless/get-started/quick-starts/wix-managed-headless/quick-start-from-your-own-frontend.md) instead.

## Before you begin

Wix serves your files as they are and doesn't build them. If your site has a build step, upload the output your framework produces, such as a `dist` folder, rather than your project source. Source files pass the upload but produce a site that doesn't run, because nothing bundles or compiles them.

Make sure what you upload is:

- **Static.** HTML, CSS, and client-side JavaScript only. Nothing runs on a server, so backends such as Express or Node servers, framework API routes, and server-rendered templates aren't deployed.
- **Entered through an HTML file at the top level.** A single HTML file works on its own. With more than one at the top level, name one of them `index.html`. Wix loads `index.html` first, so it's the safest name either way. HTML files nested only inside subfolders aren't accepted.
- **Made up of supported file types:**

  | Type | Extensions |
  | --- | --- |
  | Markup | `html`, `htm` |
  | Styles | `css` |
  | Scripts | `js`, `mjs`, `cjs`, `jsx`, `map` |
  | Images | `png`, `jpg`, `jpeg`, `gif`, `svg`, `webp`, `ico`, `avif`, `bmp` |
  | Fonts | `woff`, `woff2`, `ttf`, `otf`, `eot` |
  | Data | `json`, `xml`, `txt`, `md` |

  Any other file type, such as video or WebAssembly, is rejected. Operating system and editor metadata, such as `.DS_Store`, is ignored automatically.
- **Within the size limits.** Up to 3MB per file, and 20MB in total.

You don't need to be logged in to upload, but you do need a Wix account to keep your site.

## Step 1 | Upload your site

To upload your site:

1. Go to [wix.com/headless/drop](https://www.wix.com/headless/drop).
2. Drag your build output onto the drop zone, or select a folder or a zip file.

   This creates a `wix.config.json` file, uploads and hosts your files with SSL, CDN, and business APIs configured, and releases your site so it goes live on a `*.wix-site-host.com` URL.
3. Wait for the process to complete, then open the live URL from the success page to confirm your site is up.
4. Log in or sign up to save your site.

> **Note:** Uploading always creates a new headless project. You can't upload files into an existing one.

## Step 2 | Set up your local project

Wix now holds the files you uploaded plus a generated `wix.config.json` file that links them to your Wix project. To keep developing, download that project and set up authentication with a [Wix client](https://dev.wix.com/docs/api-reference/articles/sdk-setup-and-usage/set-up-a-wix-client.md).

Choose one of the following approaches.

::::tabs

:::Use-an-AI-agent

If you're using Claude Code with a cloud environment, select **Full network access** when you create or configure the environment. The agent needs network access to download your project files and call Wix APIs.

On the success page:

1. Select any business solutions you want, such as Stores or Bookings. This tells your agent which ones to switch on.
2. Click **Copy**. The copied prompt includes your site's download URL.
3. Paste the prompt into your coding agent.

The prompt carries your own site ID and looks like this:

```text
Help me connect to my Wix Headless site – download my project from https://www.wix.com/_api/wixstro-deployments/v1/instant-sites/YOUR_SITE_ID/download.zip and switch on only the features it needs using https://wix.com/headless/skill.md
```

If you no longer have the success page open, use the prompt above instead. Replace `YOUR_SITE_ID` with your site's ID, which you'll find in your dashboard URL immediately after `/dashboard/`.

The agent:

- Downloads your project files.
- Installs dependencies and configures it to run against your live Wix site.
- Connects it to the Wix business solutions your site needs.
- Sets up authentication.

> **Note:** Use this prompt for initial setup only. After the first iteration, keep developing with your agent as you normally would. Don't reuse it.

If your project still isn't authenticating against Wix APIs once the agent finishes, complete the steps in the **Set it up yourself** tab.

:::

:::Set-it-up-yourself

To get your project running locally, download your files, install the SDK, and create a client that authenticates your API calls using the `appId` from your `wix.config.json` file.

> **Note:** This flow requires Node.js 20.11.0 or higher.

To set up your local project:

1. Download your project files from `https://www.wix.com/_api/wixstro-deployments/v1/instant-sites/YOUR_SITE_ID/download.zip`. The URL redirects to a temporary download link, so open it in a browser or follow redirects (`curl -L`). Take `YOUR_SITE_ID` from the download URL in the copied prompt, or from your dashboard URL immediately after `/dashboard/`.

   The archive holds the files you uploaded plus a generated `wix.config.json` file:

   ```json
   {
     "projectType": "Site",
     "appId": "<YOUR_APP_ID>",
     "siteId": "<YOUR_SITE_ID>",
     "site": {
       "outputDirectory": "./dist"
     }
   }
   ```

   Before you release from the CLI, point `outputDirectory` at the folder that holds your `index.html`. For a static site with no build step, that's `"."`.

2. Install the [Wix JavaScript SDK](https://dev.wix.com/docs/sdk.md) and a package for each business solution you want to call. Domain packages follow the `@wix/{domain}` naming convention. For example:

   ```console
   npm install @wix/sdk @wix/stores
   ```

3. Create a [Wix client](https://dev.wix.com/docs/api-reference/articles/sdk-setup-and-usage/set-up-a-wix-client?apiView=SDK.md) with `OAuthStrategy`, using the `appId` from `wix.config.json` as the client ID. Pass in the modules you installed. Create the client once and reuse it across your app. For example:

   ```js
   import { createClient, OAuthStrategy } from '@wix/sdk';
   import { products } from '@wix/stores';

   const wixClient = createClient({
     modules: { products },
     auth: OAuthStrategy({
       // The appId from your wix.config.json file.
       clientId: '<YOUR_APP_ID>',
     }),
   });
   ```

   With no tokens passed, the client authenticates as an anonymous site visitor automatically, which is enough to start calling APIs.

4. Confirm the client works by calling an API.

   ```js
   const { items } = await wixClient.products.queryProducts({});
   ```

To learn more, see [About Authentication for Self-Managed Headless](https://dev.wix.com/docs/go-headless/authentication/about-authentication.md).

:::

::::

## Step 3 | Continue developing

After your project is set up, keep building:

- **Develop with an AI agent.** Point your agent at the [Wix Headless skill](https://dev.wix.com/docs/go-headless/get-started/headless-ai-toolkit.md) to finish setup and integrate Wix business solutions.
- **Manage business data in the dashboard.** Manage products, bookings, blog posts, forms, members, and more directly from your project dashboard. No code required.
- **Deploy updates with the CLI.** Make changes in your local project, build with your framework's own tooling, and run [`npx wix release`](https://dev.wix.com/docs/wix-cli/command-reference/project-commands/release.md) to publish them.
- **Preview locally.** Run `npx wix preview` to test your site locally. Along with `release`, these are the only project-level CLI commands available for this kind of project.

## See also

- [About Wix-Managed Headless](https://dev.wix.com/docs/go-headless/wix-managed-headless/about-wix-managed-headless.md)
- [Quick Start from Your Own Frontend](https://dev.wix.com/docs/go-headless/get-started/quick-starts/wix-managed-headless/quick-start-from-your-own-frontend.md)
- [About Authentication for Self-Managed Headless](https://dev.wix.com/docs/go-headless/authentication/about-authentication.md)