Stay organized with collections
Save and categorize content based on your preferences.
This section covers the stability and performance of Playables.
1 Initial bundle size
To properly test this requirement, the game may need to be ingested with
the developer portal and then tested in the test suite. Alternatively hosting
with compression on or zipping all of the initial loaded content can provide a
good approximation.
Game initial bundle size MUST be less than 30 MiB.
Game initial bundle size SHOULD be less than 15 MiB.
2 Total bundle size
By default, the game total bundle size MUST be less than 250 MiB.
Exceptions to this can be found in the FAQ.
Game SHOULD only load the minimal amount of data needed to enable
interactivity and lazy load the other data as needed.
3 Individual file size
Every individual file within the game MUST be less than 30 MiB.
Every individual file within the game SHOULD be less than 512 KiB.
4 Saved game size
Saved game size MUST be less than 3 MiB.
Saved game size SHOULD be less than 500 KiB.
5 Load time
Game SHOULD finish loading and allow user interaction in under 5
seconds.
6 Crashes
Game MUST NOT have consistently reproducible crashes.
Game MUST NOT exceed a peak JavaScript heap size of 512 MB. See the memory usage restrictions faq on why this causes crashes on iPhones.
Game MUST NOT crash the YouTube app, YouTube website, or other user
software.
7 Technologies used
Game MUST be based on standards-compliant Web APIs (e.g., JavaScript,
Canvas, WebGL) as defined by standards bodies (e.g., W3C, WHATWG).
Playables MUST be compatible with all browsers that YouTube supports
(including Edge, Chrome, Firefox, etc.)
Playables MUST be compatible with the YouTube app on Android and iOS.
8 File references
Game MUST only use relative paths when referring to other files in the
game bundle.
Game MUST NOT use absolute paths, as they will fail to load.
9 File names
Files in the game bundle MUST only contain alphanumeric and a few
special characters: _, -, ..
You can use the Playables bundle analyzer to conduct an initial validation of
the game bundle. This validation will assess the size of each individual file,
the overall bundle size, and any potential filename inconsistencies.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003ePlayables must have an initial bundle size under 15 MB and a total bundle size under 250 MB, ideally striving for 5 MB and 15 MB respectively.\u003c/p\u003e\n"],["\u003cp\u003eIndividual files within the Playable should not exceed 30 MB, with a recommended size of less than 512 KB.\u003c/p\u003e\n"],["\u003cp\u003eSaved game data must be kept under 3 MB and should ideally be less than 500 KB to ensure efficient storage.\u003c/p\u003e\n"],["\u003cp\u003ePlayables are expected to load and be interactive within 5 seconds to provide a seamless user experience.\u003c/p\u003e\n"],["\u003cp\u003eGames must be built using standard web technologies, be compatible with all YouTube-supported browsers, and not have reproducible crashes or exceed specified memory limits.\u003c/p\u003e\n"]]],["Playables' initial bundle size must be under 15 MiB, ideally under 5 MiB, to ensure quick loading. The total bundle size should be below 15 MiB, with a maximum of 250 MiB allowed in some cases. Individual files must not exceed 30 MiB, ideally staying below 512 KiB. Saved game sizes should be kept below 500 KiB, with a limit of 3 MiB, and load time should be under 5 seconds. Games must avoid crashes, adhere to standard web APIs, use relative file paths, and utilize permitted file names.\n"],null,["# Stability and performance requirements\n\nThis section covers the stability and performance of Playables.\n| **Important:** Translated requirements are provided for reference only. Refer to the [English versions of requirements](/youtube/gaming/playables/certification/requirements?hl=en) for definitive guidance.\n\n1 Initial bundle size\n---------------------\n\nTo properly test this requirement, the game may need to be ingested with\nthe developer portal and then tested in the [test suite](/youtube/gaming/playables/test_suite). Alternatively hosting\nwith compression on or zipping all of the initial loaded content can provide a\ngood approximation.\n\n- Game initial bundle size **MUST** be less than 30 MiB.\n- Game initial bundle size **SHOULD** be less than 15 MiB.\n\n| **Key Term:** *Initial bundle size* - The amount of data that the Playable needs to download in order to start the game. This is measured from the start of page load to the moment the game calls [`gameReady`](/youtube/gaming/playables/reference/sdk#gameready). Aim to keep the initial bundle size as small as possible to avoid long loading and to decrease the risk of users abandoning the game.\n| **Note:** Due to the use of HTTP compression, the transfer size of game assets is sometimes less than the stored size of the assets. To learn more, visit the [FAQ](/youtube/gaming/playables/support/certification_faq#initial-bundle-size).\n\n2 Total bundle size\n-------------------\n\n- By default, the game total bundle size **MUST** be less than 250 MiB. Exceptions to this can be found in the [FAQ](/youtube/gaming/playables/support/certification_faq#bundle-size-exception).\n- Game **SHOULD** only load the minimal amount of data needed to enable interactivity and [lazy load](https://developer.mozilla.org/docs/Web/Performance/Lazy_loading) the other data as needed.\n\n| **Key Term:** *Total bundle size* - The sum of all game files hosted by YouTube.\n\n3 Individual file size\n----------------------\n\n- Every individual file within the game **MUST** be less than 30 MiB.\n- Every individual file within the game **SHOULD** be less than 512 KiB.\n\n| **Key Term:** *Individual file size* - The size of a single game file hosted by YouTube, such as HTML, JavaScript, WASM, or media files.\n\n4 Saved game size\n-----------------\n\n- Saved game size **MUST** be less than 3 MiB.\n- Saved game size **SHOULD** be less than 500 KiB.\n\n5 Load time\n-----------\n\n- Game **SHOULD** finish loading and allow user interaction in under 5 seconds.\n\n6 Crashes\n---------\n\n- Game **MUST NOT** have consistently reproducible crashes.\n - Game **MUST NOT** exceed a peak JavaScript heap size of 512 MB. See the [memory usage restrictions faq](/youtube/gaming/playables/support/faq#memory-usage-restrictions) on why this causes crashes on iPhones.\n- Game **MUST NOT** crash the YouTube app, YouTube website, or other user software.\n\n7 Technologies used\n-------------------\n\n- Game **MUST** be based on standards-compliant Web APIs (e.g., JavaScript, Canvas, WebGL) as defined by standards bodies (e.g., W3C, WHATWG).\n- Playables **MUST** be compatible with all browsers that YouTube supports (including Edge, Chrome, Firefox, etc.)\n- Playables **MUST** be compatible with the YouTube app on Android and iOS.\n\n8 File references\n-----------------\n\n- Game **MUST** only use relative paths when referring to other files in the game bundle.\n- Game **MUST NOT** use absolute paths, as they will fail to load.\n\n9 File names\n------------\n\n- Files in the game bundle **MUST** only contain alphanumeric and a few special characters: `_`, `-`, `.`.\n\nYou can use the [Playables bundle analyzer](/youtube/gaming/playables/samples/bundle_analyzer) to conduct an initial validation of\nthe game bundle. This validation will assess the size of each individual file,\nthe overall bundle size, and any potential filename inconsistencies."]]
