> 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/how-to-publish.md).

# How to Publish

{% embed url="<https://youtu.be/GxgVWHMDv-4?si=39599wLxXao3qxvB>" %}

Publishing makes an uploaded game discoverable on Sandbox Studio. Upload first, then turn on `Published` in the game settings.

{% hint style="info" %}
**Before you begin**

Your project must already be uploaded. Follow [Uploading Your Project](/publishing/uploading-your-project.md) if it is not. Prepare the public `Name`, `Description`, `Tags`, and a thumbnail (`PNG`, `JPG`, or `WebP`, up to 2MB).
{% endhint %}

## Step 1: Open your game settings

On the Sandbox Studio home page, open `Yours` and find your game tile.

Select the notepad and pencil icon on the tile to open `Edit Game`.

## Step 2: Fill the public listing

In `Edit Game`, set the details players will see:

1. `Name` (required)
2. `Description`
3. `Thumbnail` — drag and drop an image, or click to select (`PNG`, `JPG`, or `WebP`, up to 2MB)
4. `Tags`

Leave `Published` off until those fields are ready.

![Edit Game includes a Published toggle, listing fields, and Save Changes.](https://content.gitbook.com/content/WgFjStdWWXj1Wc6xnrcJ/blobs/DDPfSQaodrqjqOcm8duY/Unknown%20image)

## Step 3: Turn on Published and save

Turn the `Published` toggle on.

Select `Save Changes`.

The game is now listed for public discovery on `Discover` (`Trending`, `Popular`, `New`, and search). The direct link from [Uploading Your Project](/publishing/uploading-your-project.md) continues to work.

{% hint style="warning" %}
**Check before publishing**

Confirm that the title, description, tags, thumbnail, and uploaded build represent the version you want players to see. Once `Published` is on and saved, anyone browsing the platform can find the game.
{% endhint %}

## Update a published game

To ship a new build or to unpublish, follow [Updating and unpublishing your game](/publishing/updating-and-unpublishing-your-game.md). Re-upload to the same game overwrites the hosted files. `Published` stays on unless you turn it off in `Edit Game`.

## Unpublish a game

Covered on [Updating and unpublishing your game](/publishing/updating-and-unpublishing-your-game.md): `Edit Game` → `Published` off → `Save Changes`.

## What You've Done

The game is uploaded and set to `Published`. Its saved `Edit Game` details determine how it is presented on Discover. To understand draft links versus a public listing, see [Sharing vs Publishing](/publishing/sharing-vs-publishing.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/how-to-publish.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.