Claude Code
AI Code Editors & Agents
Anthropic's agentic coding tool for the terminal, VS Code and JetBrains. Uses a Claude Pro/Max plan or the API.
#cli#agentHome › Godot 4 Web Export for itch.io and Poki (2026)
Godot exports to the web in a few clicks, but most “black screen on itch.io” and “too big for Poki” problems come from four settings: thread support, the renderer, compression and the engine's own download size. This guide covers each one for Godot 4.x (the current docs are for 4.7), with the exact options, the headers a threaded build needs, what itch.io, Poki and Cloudflare Pages do with them, and file sizes we measured from the official export templates. Every fact is from Godot's, itch.io's, Poki's or Cloudflare's own docs.
Last updated:
Free download · one page + PDF · updated weekly, current edition November 16, 2026
The best AI tool for each job in a solo or indie game (3D, sprites and pixel art, animation, audio, NPCs), MCP setups for Unity, Unreal, Godot and Roblox, and which free plans you can actually ship with.
Yours free when you join the VibeStack Weekly: new AI game-dev tools and releases every Monday, 5-minute read. Unsubscribe anytime.
| Setting | What to pick | Why |
|---|---|---|
| Thread Support | Off (the default since Godot 4.3) | Threaded builds need cross-origin isolation headers. Godot's docs call the single-threaded export more compatible with itch.io, Poki and CrazyGames |
| Renderer | Compatibility | Godot 4 can only target WebGL 2.0 through the Compatibility renderer. Forward+ and Mobile don't run on the web |
| Export file name | index.html | Web servers load it by default, and itch.io requires an index.html in the zip |
| Progressive Web App | Off, unless you want offline play or a threaded build on a host where you can't set headers | Its service worker can add the isolation headers for you, but it also caches old builds |
| Language | GDScript | Official Godot 4 can't export C# projects to the web yet |
| Where to host | itch.io for a free page; Poki if accepted; your own site if you control headers | Cloudflare Pages caps each file at 25 MiB, and the stock Godot 4.7.2 engine file is bigger (details below) |
Godot can't export anything until export templates are installed. Open Editor > Manage Export Templates… and install them for your editor version, either just the platforms you need or the full TPZ file from the download page (the docs say the full file has no inherent advantage and takes more space). The official Godot 4.7.2 template package contains eight Web templates: release and debug builds, each with or without threads, plus “dlink” versions with GDExtension support. Godot picks the right one from your export options.
The .NET (“mono”) template package for 4.7.2 contains no Web templates at all, which matches the docs' warning about C# (see C# and .NET below).
<head>.index.html. Keep the other file names as Godot wrote them: the docs warn that renaming exported files can cause issues.You get index.html, index.js (start-up code), index.wasm (the engine as WebAssembly), index.pck (your game's data), a boot splash PNG and a few small helper files. To export from a script or CI, the same preset works from the command line (the preset name must match yours):
godot --path /path/to/project --export-release "Web" build/web/index.htmlPresets live in export_presets.cfg, which Godot's docs say is safe to commit to version control. That's handy for AI agents too: Claude Code, Cursor or OpenAI Codex can read it and check your settings. A prompt that works: “Read export_presets.cfg and project.godot. Check that the Web preset has thread support and extensions support off, the renderer is Compatibility, and nothing loads from an external URL (fonts, scripts, analytics). List anything that would break on itch.io or Poki and propose fixes, but don't change files until I confirm.”
With a Godot MCP server connected, the agent can also run the project and read its errors itself before you export. None of the three servers we compared lists a Web export tool, though, so the export and the browser test stay with you.
Godot 4.0 to 4.2 web builds used threads, which rely on the browser's SharedArrayBuffer. After the Spectre exploits, browsers only allow that on pages that are “cross-origin isolated”, which takes two response headers on a secure (HTTPS) page:
Cross-Origin-Opener-Policy: same-origin
Cross-Origin-Embedder-Policy: require-corpGodot's own web lead put the cost bluntly in the 4.3 progress report: cross-origin isolation blocks calls to other websites, so “Adieu game monetization. Adieu interacting with an external API.” Godot 4.3 brought back single-threaded exports, and they're now the default. The trade-offs, from Godot's docs:
| Single-threaded (default) | Thread Support on | |
|---|---|---|
| Special headers | None | COOP + COEP on a secure (HTTPS) page, or the PWA workaround |
| Ads, SDKs and other sites | Work normally | Cross-origin requests fail unless the other server opts in |
| Performance | Lower: no Thread, and the docs say it's “not as performant” | Better for CPU-heavy games |
| Audio | Low-latency Sample playback (the web default) | Also allows low-latency Stream playback, with Godot's full audio features |
| macOS and iOS | Godot says it “works very well” | Historically had compatibility issues |
| GDExtension | Not available (Extensions Support also needs the headers) | Possible with Extensions Support |
Our take: ship single-threaded unless profiling shows you need threads and you control the server. Since Godot 4.5, the official web templates use WebAssembly SIMD, and the Godot team calls 1.5× to 2× a representative performance gain from it, so single-threaded builds are faster than they used to be.
index.html sits at the zip's root. itch.io takes ZIP only (no .rar, .tar.gz or .7z); up to 1,000 files, 500 MB extracted and 200 MB per file, so a Godot export is well inside the limits.Compression is automatic. itch.io's docs say its CDN gzips .html, .js, .wasm and .pck files you upload uncompressed (Godot's docs, written earlier, still list itch.io as a host without on-the-fly compression). itch.io also serves files ending in .br as Brotli. You don't need to precompress a Godot export for itch.io.
The SharedArrayBuffer checkbox. If you do export with threads, itch.io has an opt-in setting under Embed Options > Frame Options: SharedArrayBuffer support, announced in April 2022 as experimental. It moves your game to a separate CDN (html.itch.zone) that adds COOP same-origin, COEP require-corp and CORP cross-origin headers, and sets COEP credentialless on your game page. itch.io warns about the side effects: requests to other domains fail by default, iframe embeds on the page (YouTube videos in comments, for example) stop working, and saves players already have in local storage don't carry over because the domain changes. Godot's 4.3 report adds that credentialless wasn't supported by Safari or Firefox for Android, so some players couldn't run threaded games at all. Another reason to stay single-threaded.
Saves inside the itch.io iframe. Godot keeps user:// in the browser's IndexedDB. Its docs say that when a game runs in an iframe (as on itch.io), third-party cookies must be enabled for saves to persist, and incognito mode prevents persistence. OS.is_userfs_persistent() tells you whether saving works (with occasional false positives), so you can warn the player.
Poki is curated: you submit the game through Poki for Developers first. The Godot SDK plugin's README says to do the SDK integration only after the game is approved. The requirements that matter most for a Godot build:
user:// saves don't persist. Poki asks you to save progress where it makes sense or tell players when progress won't be saved.The SDK in Godot 4. Poki's docs point to the community plugin godot-poki-sdk (MIT), whose README says the runtime works in Godot 3.4+ and 4.x. For Godot 4 the README's manual setup is: add res://addons/poki-sdk/pokisdk.gd as an autoload named PokiSDK, create a Web export preset, and set its Custom HTML Shell to res://addons/poki-sdk/full-size.html. Then fire the events Poki checks in review: gameLoadingFinished() when loading is done, gameplayStart() on the player's first input (not on load) and on every return to play, gameplayStop() on every interruption, commercialBreak() at natural breaks before gameplay resumes and rewardedBreak() for opt-in rewards. Mute audio and disable input during ads. Poki's code samples use Godot 3 signal syntax (connect("commercial_break_done", self, "on_done")); in Godot 4 that's PokiSDK.commercial_break_done.connect(_on_done). Test the event flow in the Poki Inspector before you request a review.
The engine itself is the biggest file in a small Godot web game. We downloaded the official export templates on October 29, 2026 and measured the engine file (godot.wasm, which becomes index.wasm in your export):
| Official template | Uncompressed | gzip -9 | Brotli (quality 11) |
|---|---|---|---|
| Godot 4.7.2, Web single-threaded release | 39.5 MB | 10.1 MB | 7.1 MB |
| Godot 3.6.3, WebAssembly release | 19.8 MB | 5.4 MB | 3.8 MB |
Your game's .pck and index.js (about 0.28 MB before compression in 4.7.2) come on top. Godot's May 2024 report gave similar numbers for 4.3: about 40 MB uncompressed and 5 MB with Brotli.
So a stock Godot 4 export is over Poki's 5 MB initial-download guideline before any of your game's content loads, even with Brotli. The ways to shrink it, all from Godot's “Optimizing a build for size” docs, need a custom export template compiled with Emscripten:
build_profile=…). The docs warn it can be too aggressive for features used dynamically, so test the whole game.optimize=size_extra, added in Godot 4.5, goes further than the size mode official web builds already use.disable_3d=yes for 2D games (the docs estimate about 15% smaller), and the fallback text server if you only need Latin, Greek and Cyrillic text.We haven't measured how small a custom 4.7 template gets for a real game, so treat Poki's 5 MB as a target to test against, not a promise. For your own assets: compress textures and audio, and keep the .pck lean.
The 25 MiB catch. Cloudflare Pages caps every file at 25 MiB. The stock Godot 4.7.2 index.wasm is 39.5 MB uncompressed, so a default Godot 4 export won't upload to Pages as it is (the Godot 3.6.3 engine, at 19.8 MB, fits). Cloudflare's own suggestion for bigger files is an R2 public bucket, which puts the engine on a second domain; we haven't tested that setup with Godot. A custom size-optimized template may get under the limit, but check the file size before you plan around it.
Headers for a threaded build. On hosts that let you set response headers, a threaded export needs COOP and COEP. On Cloudflare Pages that's a plain-text file called _headers in the folder you deploy, for example for a game in /play/:
/play/*
Cross-Origin-Opener-Policy: same-origin
Cross-Origin-Embedder-Policy: require-corpScope the rule to the game's path: the same headers on your whole site would break embeds and third-party scripts on your other pages. Single-threaded exports don't need a _headers file at all.
Compression on your own host. Godot's docs recommend compressing .wasm and .pck on the server: the WebAssembly file shrinks to about a quarter with gzip, and Brotli does better if your server can serve precompressed files. Serve .wasm as application/wasm, or browsers skip some start-up optimizations. Cloudflare's compression docs list application/wasm among the content types it compresses automatically. GitHub Pages gzips on the fly, according to Godot's docs. Whatever the host, check the Content-Encoding header on index.wasm in your browser's Network tab.
Comparing free hosts on limits and pricing? See how to publish an HTML5 game, which also covers Playgama and CrazyGames.
Ticking Progressive Web App > Enable in the Web preset does three things, per Godot's docs:
The catch: service workers cache aggressively. Godot's troubleshooting section describes an old build (or another project) showing up instead of the new one; the fix is DevTools > Application > Service workers > Unregister (or tick Update on reload). Leave PWA off for itch.io and Poki unless you need it.
Since Godot 4.3, web exports play audio through the browser's Web Audio API as samples by default. That keeps latency low even without threads, but the docs list what you lose: AudioEffects (reverb, delay and the rest on your buses), reverb and Doppler, procedural audio generation, and sometimes correct positional audio. To get Godot's full audio features back, set Audio > General > Default Playback Type.web to Stream, or set Playback Type to Stream on individual AudioStreamPlayer nodes. The class reference warns that forcing Stream can cause high latency and crackling, so do it only for the players that need effects.
Two more audio rules: browsers block sound until the player clicks, taps or presses a key, so put a “click to start” screen first (itch.io's Click to play covers this). And to avoid a hitch the first time a sound plays, register streams while the level loads with AudioServer.register_stream_as_sample().
Godot's 4.7 docs still say it plainly: projects written in C# using Godot 4 can't be exported to the web; use Godot 3 for C# web games. In May 2025 the Godot team showed a working prototype that statically links the Mono runtime (a draft pull request) and said it couldn't commit to a timeline. As of October 2026 the official 4.7.2 .NET templates still have no Web export. If the web is your main target, write the game in GDScript, or use Godot 3.x if you need C#.
_input), not on startup.TouchScreenButton or Godot 4.7's VirtualJoystick, and plan around iPhone Safari having no element fullscreen; see touch controls for HTML5 games.localhost is usually exempt while testing.index.html. Serve the folder from a local web server.serve.py: save the script from the Godot repository into your export folder and run python serve.py --root . (it listens on port 8060 by default and sends the COOP/COEP headers, so threaded builds work too). Godot says not to use it in production.index.html; file names unchanged; zip contents, not the folderindex.wasm + index.pck size checked against your platform (Poki: 5 MB initial; Cloudflare Pages: 25 MiB per file)Related: best AI tools for Godot · publish an HTML5 game (itch.io, Poki, CrazyGames, Playgama) · put a web game on Steam (Godot can also export native desktop builds, so you can skip the wrapper) · Steam launch checklist · itch.io AI disclosure.
Shipping Godot games to the web? Get the VibeStack Weekly digest: new AI game-dev tools and web publishing changes, every Monday.
Sources (checked October 29, 2026): Godot documentation for 4.7 (Exporting for the Web; Exporting projects; Optimizing a build for size; Compiling for the Web; AudioServer and ProjectSettings class reference); godotengine.org blog posts “Web Export in 4.3” (May 2024), “Live from GodotCon Boston: Web .NET prototype” (May 2025) and “Upcoming (serious) Web performance boost” (June 2025); the Godot 4.7.2 and 3.6.3 export template packages on GitHub (file sizes measured by us), plus the 4.7.2 Web exporter source and serve.py; itch.io creator docs (Uploading HTML5 games) and itch.io's “Experimental SharedArrayBuffer Support” announcement; Poki for Developers (Choosing your web game engine, Requirements, External resources policy, PokiSDK: Godot) and the vkbsb/godot-poki-sdk README; Cloudflare docs (Pages Headers, Pages Limits, Content compression). The recommendations (which settings to pick, the order of steps) are ours.
AI Code Editors & Agents
Anthropic's agentic coding tool for the terminal, VS Code and JetBrains. Uses a Claude Pro/Max plan or the API.
#cli#agentAI Code Editors & Agents
AI-first code editor with agent mode, built on VS Code.
#editor#agentAI Code Editors & Agents
OpenAI's coding agent: CLI, IDE extension, web and cloud tasks. Included in ChatGPT plans (Free with limits). Unity ships an official Codex skills plugin (unity@unity-agent-plugin) for Unity 6+. The ModRetro Chromatic plugin (November 2026) builds Game Boy and Game Boy Color games as GB Studio projects, playtests them in a built-in emulator and can flash them to a Chromatic handheld cartridge.
#cli#agentAI Code Editors & Agents
AI pair programmer and coding agent across VS Code, JetBrains and the CLI. Free plan available; Gemini 4 Argon on Pro+ and higher.
#editor#agent#githubReach builders, vibe coders & indie game devs. Featured listings from $49/mo.
Advertise →Usually because the export has Thread Support (or Extensions Support) on. Those builds need cross-origin isolation headers (COOP same-origin and COEP require-corp). Turn Thread Support off, which is the default since Godot 4.3, and re-export. If you really need threads, tick itch.io's experimental SharedArrayBuffer support option under Embed Options > Frame Options.
Only for exports with Thread Support or Extensions Support enabled. The default single-threaded export since Godot 4.3 needs no special headers, which is why Godot's docs call it more compatible with itch.io, Poki and CrazyGames.
Not with official Godot 4 as of October 2026. The docs say Godot 4 C# projects can't be exported to the web and suggest Godot 3 for C# web games. The Godot team showed a prototype in May 2025 but hasn't given a release date.
The engine file alone is large: in our measurement, the official Godot 4.7.2 single-threaded release template's WebAssembly file is 39.5 MB uncompressed, about 10.1 MB with gzip and 7.1 MB with Brotli. Your game's .pck comes on top. Custom export templates with unused features disabled can make it smaller.
It works, but size is the hurdle. Poki recommends an initial download under 5 MB and 8 MB total, lists an empty Godot project at 10 MB compressed, and recommends Godot 3.5 for web-exclusive games. With Godot 4, plan on a size-optimized custom export template, and integrate the Poki SDK (the godot-poki-sdk plugin supports Godot 4) after Poki approves the game.
Only if every file is 25 MiB or less, which is Cloudflare Pages' per-file limit. The stock Godot 4.7.2 engine file is 39.5 MB uncompressed, so a default export won't upload; Godot 3.x or a size-optimized custom template can fit. For threaded builds, add COOP and COEP headers with a _headers file.
Browsers block audio until the player clicks, taps or presses a key, so add a click-to-start screen. If sound plays but effects are missing, that's because Godot web exports use Sample playback by default, which doesn't support AudioEffects, reverb or Doppler. Switch specific players to Stream playback if you need them.
Serve the folder over a local web server instead of opening index.html directly. Use the editor's run-in-browser button, or Godot's serve.py script (python serve.py --root .), which also sends the headers threaded builds need. Then test in Chrome, Firefox, Safari, on a phone and in incognito.
Free download · one page + PDF · updated weekly, current edition November 16, 2026
The best AI tool for each job in a solo or indie game (3D, sprites and pixel art, animation, audio, NPCs), MCP setups for Unity, Unreal, Godot and Roblox, and which free plans you can actually ship with.
Yours free when you join the VibeStack Weekly: new AI game-dev tools and releases every Monday, 5-minute read. Unsubscribe anytime.