---

sidebar_position: 11

---

# Publishing your map

You have three ways to host your map, but only one is recommended for new projects.

## Recommended (start here) 

<iframe width="100%" height="480" src="https://www.youtube.com/embed/5yTB23mcnP0?si=v2flBIjYB5Qwr1uy" title="Upload your map - With the web app" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>

[Upload your map to the WorkAdventure server](./wa-hosted).
This is the easiest setup and the supported path going forward, whether you upload locally or from a CI/CD pipeline.

<div class="text--center margin-top--lg">
    <a href="./wa-hosted" class="button button--primary">Upload your map to the WorkAdventure server &gt;</a>
</div>

## Legacy options

In the past, WorkAdventure could not host maps directly on its server. Therefore, we had to rely on third-party websites for map hosting.
These options are still supported, but they are not recommended for new projects. They are more complex to set up and maintain, and they do not offer any significant advantage over hosting on the WorkAdventure server.

- [**Host your map on GitHub Pages**](./github-pages): push your map to a GitHub repository and GitHub hosts it for you.
- [**Host your map on a self-hosted web server**](./hosting): host on your own web server for maximum freedom or special privacy needs.

```mermaid
flowchart TB
  subgraph Self-hosted
    direction BT
    Y3[Your computer] -- upload map --> WS[Your web server]
    WA3[WorkAdventure] -. load map .-> WS
  end
  subgraph GitHub pages
    direction BT
    Y2[Your computer] -- push --> GH[GitHub]
    GH[GitHub] -- GitHub actions --> GHP[GitHub Pages]
    WA2[WorkAdventure] -. load map .-> GHP
  end
  subgraph WorkAdventure
    direction BT
    Y1[Your computer] -- upload map --> WA1[WorkAdventure]
  end
  style WA1 fill:#14304C,color:#fff
  style WA2 fill:#14304C,color:#fff
  style WA3 fill:#14304C,color:#fff
```
