> 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/updating-and-unpublishing-your-game.md).

# Updating and unpublishing your game

After the first upload and publish, you ship changes by uploading again and you leave Discover by turning `Published` off. This page is that loop. First-time upload is [Uploading Your Project](/publishing/uploading-your-project.md). First-time listing is [How to Publish](/publishing/how-to-publish.md).

## Step 1: Save and build before you upload

Save with `Ctrl+S` / `Cmd+S`. If you changed TypeScript, run `pnpm build` from the project root, then **Build Project** (`Ctrl+B` / `Cmd+B`). The upload panel sends the current project on disk. Unsaved or unbuilt code will not be in the hosted game.

## Step 2: Upload onto the same game

1. Select the cloud icon in the editor toolbar.
2. Select the **existing** game — not `Create a New Game`.
3. Select `Upload`. **Upload Game Assets** opens with files from `.dist`. Pending files are selected; unchanged files are not. Confirm the selection, then select `Upload N files`.
4. Wait for the progress bar to finish, then close the window.

That upload **overwrites** the previous hosted files for that game with the files that completed. `Published` stays as you left it in `Edit Game`. You do not turn the toggle off and on for the files to update.

{% hint style="info" %}
*NOTE: Do not close the editor or **Upload Game Assets** while the progress bar is running. Stopping it can leave an incomplete hosted build.*
{% endhint %}

After you close the window, open the game from `Yours` and use the play link. That is how you confirm the new build. This page does not describe what a player already in an open session sees mid-upload.

The **Upload Game Assets** window is shown on [Uploading Your Project](/publishing/uploading-your-project.md).

## Step 3: Change the public listing if you need to

If the name, description, tags, or thumbnail should change with this version, open `Edit Game` from the notepad-and-pencil control on the tile. Thumbnail files: `PNG`, `JPG`, or `WebP`, up to 2MB. Select `Save Changes`.

## Step 4: Unpublish

To take the game off public discovery:

1. Open `Yours` on the home page.
2. Open `Edit Game`.
3. Turn the `Published` toggle **off**.
4. Select `Save Changes`.

The game is no longer listed on `Discover` (`Trending`, `Popular`, `New`, search). It remains on `Yours` as an unpublished draft. Direct links still work in that draft state — see [Sharing vs Publishing](/publishing/sharing-vs-publishing.md).

Turning `Published` on again and saving puts it back on Discover.

`Edit Game` also has **Delete**. That is not unpublish. Do not use Delete when you only mean to leave Discover.

## There is no upload rollback in the editor

Re-upload replaces the hosted files. The editor does not offer a restore-previous-upload control. Keep a known-good project in **Git** so you can return the files on disk, then upload that commit. See [Setting up Git](/source-control/setting-up-git.md) and [Daily Git workflow](/source-control/daily-git-workflow.md).

## If upload fails

| What you see                               | What to do                                                                                                                                           |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Windows or the editor warns about the file | Confirm you started from the cloud icon in this project's editor, not a random copy of the files.                                                    |
| Transfer stops or the editor was closed    | Run the upload again onto the **same** existing game and wait until it finishes.                                                                     |
| Hosted game looks old after upload         | Confirm you selected the existing game (not a new one), that save and `pnpm build` / Build Project ran first, then open the link again from `Yours`. |

**Upload Game Assets** shows the size of the selected pending files. There is no separate documented size cap in the editor beyond finishing a complete transfer.

## What You've Done

You can overwrite a published game by uploading to the same entry, update listing fields in `Edit Game`, and leave Discover with `Published` off. Git holds versions of the project; the host holds the last finished upload.


---

# 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/updating-and-unpublishing-your-game.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.