<br />

<br />

This page provides a revision history for the following documents:

- [Accessibility Requirements](https://developers.google.com/youtube/gaming/playables/certification/requirements_accessibility)
- [Monetization requirements](https://developers.google.com/youtube/gaming/playables/certification/requirements_monetization)
- [Playables Game Design Guidelines](https://developers.google.com/youtube/gaming/playables/certification/requirements_design)
- [Playables SDK](https://developers.google.com/youtube/gaming/playables/reference/sdk)
- [Technical Requirements](https://developers.google.com/youtube/gaming/playables/certification/requirements_technical)
- [Trust and Safety requirements](https://developers.google.com/youtube/gaming/playables/certification/requirements_trustsafety)

## October 16, 2026

- Updated [Monetization requirements](https://developers.google.com/youtube/gaming/playables/certification/requirements_monetization) to note that failure to adhere to them may result in monetization features being turned off, and added requirements for real-world monetary rewards (Section 1), rewarded ads (Section 2.1), interstitial ads (Section 2.2), and advertiser-friendly content (Section 4).

## August 25, 2026

- Updated [Trust and Safety requirements](https://developers.google.com/youtube/gaming/playables/certification/requirements_trustsafety) to add the duplicate content policy (Section 2.2) requiring original, authorized, or licensed content and prohibiting duplicate game builds.

## August 24, 2026

- Added [Game accessibility tags](https://developers.google.com/youtube/gaming/playables/certification/requirements_accessibility) (Sections 2 and 2.1) covering Accessible Gaming Initiative (AGI) player discovery and developer metadata accuracy.

## July 11, 2024

- Refactored the technical requirements into multiple pages.
- Requirements cleanup and deduplication.

## June 24, 2024

Increased total bundle size limit from 100 MiB to 250 MiB and added lazy loading
guidance.

## June 17, 2024

Test Suite Updates:

- Games no longer need to be served over HTTPS and can be served from localhost for testing.
- Refresh button added next to URL field to refresh content of iframe without reloading the entire Test Suite.

## May 16, 2024

Move the design best practices to a separate document to better delineate
between design requirements and best practices.

## May 08, 2024

Refactored the Playables developer site to broaden access and improve
navigation.

## May 07, 2024

Updated the [Technical Requirements](https://developers.google.com/youtube/gaming/playables/certification/requirements_technical) for [Game Ready Notification](https://developers.google.com/youtube/gaming/playables/certification/requirements_technical#32_game_ready_notification) with
additional details for the `firstFrameReady` call.

## May 3, 2024

- Created an archive of previous requirements versions.

## March 05, 2024

Increased individual file size limit from 10 MiB to 30 MiB.

## February 23, 2024

Added `IN_PLAYABLES_ENV` boolean to top level namespace to tell developers when
their game is running within the Playables environment.

## December 04, 2023

**Test Suite updates**

- Added check for unsupported characters in file names.
  - For information on supported characters, check [Technical Requirements -
    1.9 File names](https://developers.google.com/youtube/gaming/playables/certification/requirements_stability).
  - Known limitation: This check may not validate all loaded resources.
- Added feature to mock the loading screen, including setting the initial iframe height be set to 0.
- Updated the pause-resume button to more closely match production by toggling audio when pausing and resuming.
- Removed non-actionable messages from event logging.

## November 10, 2023

The downloadable Test Suite bundle has been replaced with the hosted [Test
Suite](https://developers.google.com/youtube/gaming/playables/test_suite).

The TypeScript type definitions file, previously available in the Test Suite
bundle, has been moved to the main [Playables SDK](https://developers.google.com/youtube/gaming/playables/reference/sdk) article.

## September 07, 2023

The [Get started](https://developers.google.com/youtube/gaming/playables/reference/sdk#get_started) section has been updated to change the Playables
SDK URL from `v0` to `v1`.

## August 30, 2023

The [File names](https://developers.google.com/youtube/gaming/playables/certification/requirements_technical#19_file_names) and [Thumbnails](https://developers.google.com/youtube/gaming/playables/certification/requirements_technical#231_thumbnails) sections have been
updated to remove references to explicitly list the allowed special characters
(`_`, `-`, `.`).

Additionally, [Cloud saves](https://developers.google.com/youtube/gaming/playables/certification/requirements_technical#34_cloud_saves) section has been updated to require
cloud saves to work in new game versions.

## August 25, 2023

The [saveData](https://developers.google.com/youtube/gaming/playables/reference/sdk#savedata) section has been updated to clarify that a save data
must be a valid and well-formed UTF-16 string.

## August 18, 2023

The [Pause and resume](https://developers.google.com/youtube/gaming/playables/certification/requirements_technical#38_pause_and_resume) section has been updated to clarify that the
game must pause all executions after `onPause` is called and only resume once
`onResume` is called.

## August 11, 2023

The [File names](https://developers.google.com/youtube/gaming/playables/certification/requirements_technical#19_file_names) section has been added to include character
limitations used to name files in the game bundle.

## August 10, 2023

The [Interaction methods](https://developers.google.com/youtube/gaming/playables/certification/requirements_technical#22_interaction_methods) section has been updated to require all
of the UI components of a game to work as intended and without errors or
unexpected behaviors.

## August 09, 2023

The [Thumbnail images](https://developers.google.com/youtube/gaming/playables/certification/requirements_design#thumbnail_images) section has been added to list the game's
thumbnail requirements allowing users to effortlessly discover and recognize a
Playable in YouTube.

## August 08, 2023

The [Gestures and input](https://developers.google.com/youtube/gaming/playables/certification/requirements_design#gestures_and_input) section has been updated to prohibit the
game to call `preventDefault()` on <kbd>Esc</kbd> events.

Additionally, a new [File references](https://developers.google.com/youtube/gaming/playables/certification/requirements_technical#18_file_references) section has been added to require
games to only use relative paths when referring to other files in the bundle as
using absolute paths can cause error.

## August 02, 2023

The Mute section of both the [Technical Requirements](https://developers.google.com/youtube/gaming/playables/certification/requirements_technical) and [Playables Game Design
Guidelines](https://developers.google.com/youtube/gaming/playables/certification/requirements_design) have been updated to refer to the mute and unmute features as *audio
controls* and to indicate that the granular audio controls may contain either
volume sliders or a mute toggle or both.

## July 28, 2023

The [Playables Game Design Guidelines](https://developers.google.com/youtube/gaming/playables/certification/requirements_design) documentation has been updated to
standardize verbiage and update best practices and screenshots.

## July 20, 2023

The [Pause and resume](https://developers.google.com/youtube/gaming/playables/certification/requirements_technical#38_pause_and_resume) section has been added to provide
cross-platform pause and resume capabilities.

## July 19, 2023

The YouTube Playables site now includes the [Playables Game Design Guidelines](https://developers.google.com/youtube/gaming/playables/certification/requirements_design)
documentation to serve as a guide in providing an optimal game experience for
users playing YouTube games across different devices and platforms.

The game design guidelines focuses on the following areas:

- Thumbnail images
- Device adaptation
- User Interface (UI)
- Gestures and input
- Pause
- Mute
- Haptic feedback
- User onboarding
- Game end (win screen)
- Accessibility

Additionally, the [`onAudioEnabledChange`](https://developers.google.com/youtube/gaming/playables/reference/sdk#onaudioenabledchange) section has been updated to fix a
small typographical error on the code which caused an error in Flutter's
proposed JavaScript interoperability (JS-Interop) layer.

## July 14, 2023

The [Size](https://developers.google.com/youtube/gaming/playables/certification/requirements_technical#21_size) section has been updated as follows:

- Removed the requirement that the game must be playable in full-screen on a desktop and in landscape or portrait on mobile.
- Added that the game must be playable in portrait.
- Added that the game should be playable in landscape. Otherwise, the game must be centered or must include a pillarbox.
- Added that the game must not lock device orientation.

## July 11, 2023

The [Flutter web (experimental)](https://developers.google.com/youtube/gaming/playables/samples/flutter_wrapper) section has been added to enable
integration with games written with Flutter Web.

## July 01, 2023

The [Mute toggle](https://developers.google.com/youtube/gaming/playables/certification/requirements_technical#35_mute_toggle) section requires the game to respect the audio
setting of both YouTube and the system and that the game sound must not play
unexpectedly.

Additionally, [Completion of Content Handling](https://developers.google.com/youtube/gaming/playables/certification/requirements_technical#36_completion_of_content_handling) section
clarifies that the game must communicate to the user that there is no more
content to interact with such as in the final level or game completion.

## June 30, 2023

The [Get started](https://developers.google.com/youtube/gaming/playables/reference/sdk#get_started) section now includes a note that the SDK would be
a no-op when the game is served locally. To verify SDK integration correctness,
see [SDK Test Suite](https://developers.google.com/youtube/gaming/playables/reference/test_suite_guide).

## June 02, 2023

The YouTube Playables site now includes the [Playables SDK](https://developers.google.com/youtube/gaming/playables/reference/sdk) documentation that
features a robust set of APIs to support YouTube games.

## May 26, 2023

The [Technical Requirements](https://developers.google.com/youtube/gaming/playables/certification/requirements_technical) documentation updates are as follows:

| Section | Changes |
|---|---|
| **Load time** | Included the average internet speed of 6.8Mbps worldwide and 20Mbps for US. |
| **Interaction methods** | Added that when a user interacts with the game, the game must not unintentionally delay or ignore input. |
| **Thumbnails** | Updated the required image resolutions for the 1:1, 5:7, and 16:9 ratios. |
| **Publisher or Developer information** | Added this new section requiring the game to include the name of the publisher or developer and may also be required to provide content rating in the future. |
| **Load Playables SDK** | Added this new section requiring the game to load the Playables SDK before any of the other game code. |
| **Game Ready Notification** | Updated to call the `firstFrameReady` API only when the first frame of your game is ready to be rendered on the screen and to only call the `gameReady` API when the game is ready for any user interaction. |
| **Mute toggle** | Added that when the YouTube mute is set, the audio must not be output and the game's mute or unmute controls must not affect the audio output. |

<br />

## March 24, 2023

The YouTube Playables site now includes the [Technical Requirements](https://developers.google.com/youtube/gaming/playables/certification/requirements_technical)
documentation with the aim to provide a smooth gaming experience to users
playing games on YouTube.

The technical requirements section focuses on the following areas:

- Game stability
- YouTube experience
- YouTube integration
- Localization
- Monetization