> For the complete documentation index, see [llms.txt](https://studio-docs.sandbox.game/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://studio-docs.sandbox.game/publishing/uploading-your-project.md).

# Uploading Your Project

Before you can share your game or test it in the browser, you need to upload your project through the Sandbox Studio editor. This takes a few minutes and does not require any command-line tools.

## Step 1: Open the Upload Panel

Select the cloud icon in the top-right corner of the editor toolbar to open the upload panel.

![The cloud-with-arrow button in the editor toolbar opens the upload panel](https://2877193296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWgFjStdWWXj1Wc6xnrcJ%2Fuploads%2Fgit-blob-5f3c9915533b6e192f6c5c430031e0caf3092327%2Fupload-cloud-icon.png?alt=media)

{% hint style="info" %}
*NOTE: The upload panel uploads your current project state. If you have unsaved changes or a build that has not run, those changes will not be reflected. Save with `Ctrl+S` / `Cmd+S`, then run `pnpm build` from your project root before uploading if you have made recent code changes.*
{% endhint %}

## Step 2: Select or Create a Game

The upload panel will ask whether you want to upload to an existing game or create a new one.

* Existing game: Select it from the list. The upload will overwrite the previous version.
* New game: Select `Create a New Game`, then fill in the form:
  1. Enter a `Name` (required)
  2. Optionally add a `Description` and `Tags`
  3. Select `Create Game`

![Choose an existing game or create a new one before uploading.](https://content.gitbook.com/content/WgFjStdWWXj1Wc6xnrcJ/blobs/z0VDbAl0cC5TlBc30tgi/Unknown%20image)

![The Create New Game form asks for Name, Description, and Tags.](https://content.gitbook.com/content/WgFjStdWWXj1Wc6xnrcJ/blobs/G1vCP0HK4gkcIAeTdlTt/Unknown%20image)

{% hint style="info" %}
*TIP: The name you set here is the internal project name, not the public display name. You can update display details later from the game dashboard.*
{% endhint %}

## Step 3: Confirm files in Upload Game Assets

Press `Upload`. The **Upload Game Assets** window lists files from the project's `.dist` folder. The summary shows how many files were found, how many are **pending**, and how many are **unchanged**.

Pending files are selected for this transfer. Unchanged files stay in the list but are not selected. Search, `All Types`, `Select All`, and `None` change which rows are checked. The footer shows how many files are selected, how many are pending upload, and the total size of that selection.

Select `Upload N files` (the button also shows how many are unchanged). A progress bar runs while those files transfer. Stay until the bar finishes.

When the transfer is complete, close the window. The hosted files are then the ones that finished uploading.

![Upload Game Assets lists pending and unchanged files from .dist, with search, type filter, and an Upload button.](https://2877193296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWgFjStdWWXj1Wc6xnrcJ%2Fuploads%2Fgit-blob-cbb6a1debf6681855ce0a6666a12fed04b7432bf%2Fupload-game-assets.png?alt=media)

{% hint style="info" %}
*NOTE: Do not close the editor or this window while the progress bar is running. Interrupting the transfer can leave an incomplete hosted build. Close it only after the upload finishes.*
{% endhint %}

## Step 4: Close the window and open the play link

When the progress bar has finished, close **Upload Game Assets**. Select the house icon in the top-left corner of the editor to return to the Sandbox Studio home page.

![The home page uses Discover tabs including Yours.](https://content.gitbook.com/content/WgFjStdWWXj1Wc6xnrcJ/blobs/zXJmS8G4Q8k104CssJHh/Unknown%20image)

## Step 5: Preview and Share Your Project

Your project is now on the platform as an unpublished draft. Open `Yours` on the home page to find it.

1. Click the project tile to open it in the browser and preview it
2. Copy the URL from your browser's address bar to share with anyone for testing — no account is required to access an unpublished draft link

{% hint style="info" %}
*TIP: The draft link works for anyone you send it to. Use it to gather feedback from testers before publishing publicly.*
{% endhint %}

## What You've Done

Your project is uploaded and accessible as an unpublished draft. Share the link with testers, play it in the browser, and return to the editor any time to make changes and re-upload.

Ready for a public listing? See [How to Publish](/publishing/how-to-publish.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://studio-docs.sandbox.game/publishing/uploading-your-project.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.