Home › Godot 4 Web Export for itch.io and Poki (2026)

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

🎁 Free: The AI Game Dev Stack 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.

Quick answers

SettingWhat to pickWhy
Thread SupportOff (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
RendererCompatibilityGodot 4 can only target WebGL 2.0 through the Compatibility renderer. Forward+ and Mobile don't run on the web
Export file nameindex.htmlWeb servers load it by default, and itch.io requires an index.html in the zip
Progressive Web AppOff, unless you want offline play or a threaded build on a host where you can't set headersIts service worker can add the isolation headers for you, but it also caches old builds
LanguageGDScriptOfficial Godot 4 can't export C# projects to the web yet
Where to hostitch.io for a free page; Poki if accepted; your own site if you control headersCloudflare Pages caps each file at 25 MiB, and the stock Godot 4.7.2 engine file is bigger (details below)

Step 1: install the Web export templates

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).

Step 2: add a Web preset and set the options

  1. Switch the renderer to Compatibility (Project Settings, or the renderer menu at the top right of the editor) and test the game in it before you export.
  2. Project > Export… > Add… > Web. The defaults in Godot 4.7.2's Web exporter: Thread Support off, Extensions Support off, VRAM Texture Compression For Desktop on and For Mobile off, Canvas Resize Policy “Adaptive” (the canvas fills the browser window), Progressive Web App off.
  3. Mobile players? Turn on VRAM Texture Compression For Mobile too if you use VRAM-compressed textures. Godot's docs say enabling both gives a bigger but more compatible export.
  4. Don't edit the exported HTML. Godot regenerates it on every export and your changes are lost. Use the Custom HTML Shell option for a custom page, or Head Include to add tags to <head>.
  5. Export Project into an empty folder (it must already exist) and name the file 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.html

Presets 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.

Threads or no threads: the COOP/COEP question

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-corp

Godot'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 headersNoneCOOP + COEP on a secure (HTTPS) page, or the PWA workaround
Ads, SDKs and other sitesWork normallyCross-origin requests fail unless the other server opts in
PerformanceLower: no Thread, and the docs say it's “not as performant”Better for CPU-heavy games
AudioLow-latency Sample playback (the web default)Also allows low-latency Stream playback, with Godot's full audio features
macOS and iOSGodot says it “works very well”Historically had compatibility issues
GDExtensionNot 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.

Publishing a Godot build on itch.io

  1. Zip the contents of the export folder so 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.
  2. On the project's edit page, pick “HTML Game” as the Kind of Game and upload the zip.
  3. Under Embed options, either set the viewport size (Embed in page) or pick Click to launch in fullscreen. Leave Click to play on: itch.io notes that audio may be muted in some browsers when a game auto-starts, and browsers need a click before playing sound anyway. Turn on the fullscreen button, and tick Mobile Friendly only if you've tested on phones.

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.

Publishing a Godot game on Poki

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:

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.

File size: Godot 4 vs Poki's 5 MB budget

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 templateUncompressedgzip -9Brotli (quality 11)
Godot 4.7.2, Web single-threaded release39.5 MB10.1 MB7.1 MB
Godot 3.6.3, WebAssembly release19.8 MB5.4 MB3.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:

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.

Hosting on your own site (Cloudflare Pages and others)

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-corp

Scope 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.

The Progressive Web App option

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.

Audio on the web

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().

C# and .NET

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#.

Other web limitations to plan for

Testing locally

Pre-upload checklist

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.

Get the Starter Stack ($12) Get the free weekly digest

Our picks (4)

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#agent
freemium

Cursor

AI Code Editors & Agents

AI-first code editor with agent mode, built on VS Code.

#editor#agent
freemium

OpenAI Codex

AI 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#agent
freemium

GitHub Copilot

AI 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#github

+ Your tool here

Reach builders, vibe coders & indie game devs. Featured listings from $49/mo.

Advertise →
🧰 The Vibe Coder's Starter Stack: AI rules files, a prompt library and a ship-it checklist. $12.
Get the pack

FAQ

Why does my Godot 4 web export show a black screen or a SharedArrayBuffer error on itch.io?

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.

Does Godot 4 need COOP and COEP headers?

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.

Can I export a C# Godot 4 game to the web?

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.

How big is a Godot 4 web export?

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.

Is Godot good for Poki?

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.

Can I host a Godot 4 web game on Cloudflare Pages?

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.

Why is there no sound in my Godot web game?

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.

How do I test a Godot web export locally?

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

📬 Get the VibeStack Weekly + the free AI Game Dev Stack 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.