Walk your first avatar in five minutes
Three ways in, fastest first. Try the live page, drop an avatar onto your own site with a single script tag, or turn on the companion that walks with you across three.ws.
1 · Try it live (zero setup)
Open three.ws/walk. Move with W A S D or the arrow keys, hold Shift to run, press Space to jump, and tap a number key for a gesture. On a phone, use the on-screen joysticks. The full control reference lives on the walk page docs.
2 · Put an avatar on your own site (one tag)
The fastest integration is a single <script> tag. Drop this
into the <body> of any page on any origin — no build step, no
framework, no API key:
<script src="https://three.ws/walk-embed-sdk.js"
data-position="bottom-right"
data-width="220"
data-height="320"></script>That injects a fixed-position, transparent iframe in the corner and starts a slow circular walk. To show a specific avatar, add its id:
<script src="https://three.ws/walk-embed-sdk.js"
data-avatar="YOUR-AVATAR-UUID"
data-position="bottom-left"
data-env="beach"></script>data-avatar and the SDK falls back to the bundled default avatar — served same-origin, so it works in dev, preview, and production without any CORS setup.
Want full programmatic control instead of attributes? See the JavaScript SDK reference. Prefer to manage the iframe yourself? See the iframe embed guide.
3 · Walk across three.ws (companion mode)
On three.ws itself, the Walk button in the top navigation detaches your avatar from the page and lets it stroll around — and it follows you as you navigate between pages. You can also force it on with a query parameter on any three.ws URL:
https://three.ws/?walk=1Read more in Companion mode.
Next steps
- The walk page — every control, camera, environment, gesture, and AR.
- JavaScript SDK — drive the avatar at runtime:
setAvatar,setEnv,setPosition, events. - Analytics — measure sessions, distance, and conversions per avatar.
- Chrome extension — your avatar on every website you visit.