Revision History
Stay organized with collections
Save and categorize content based on your preferences.
November 17, 2020
This update contains the following changes:
October 20, 2016
This update contains the following changes:
-
The Subscribe Button has been updated so that users do not subscribe to or unsubscribe from a channel just by clicking on a button. Now, when a user clicks on a button, the channel page associated with that button opens in a new window.
- If the user was not previously subscribed to the channel, the page displays a confirmation dialog so that the user can verify the intent to subscribe to the channel.
- If the user was already subscribed to the channel, the user can unsubscribe from the channel page.
-
The Subscribe Button no longer fires an event when a user clicks the button to subscribe to or unsubscribe from a channel. (The button had supported subscribe and unsubscribe events.) The data-ytonevent attribute, which could previously be used to specify an event listener, has also been deprecated.
In light of this change, the gapi.ytsubscribe.render method no longer supports the onytevent option, which could previously be used to specify an event listener.
August 11, 2016
This update contains the following changes:
-
The newly published YouTube API Services Terms of Service ("the Updated Terms"), discussed in detail on the YouTube Engineering and Developers Blog, provides a rich set of updates to the current Terms of Service. In addition to the Updated Terms, which will go into effect as of February 10, 2017, this update includes several supporting documents to help explain the policies that developers must follow.
The full set of new documents is described in the revision history for the Updated Terms. In addition, future changes to the Updated Terms or to those supporting documents will also be explained in that revision history. You can subscribe to an RSS feed listing changes in that revision history from a link in that document.
December 18, 2015
European Union (EU) laws require that certain disclosures must be given to and consents obtained from end users in the EU. Therefore, for end users in the European Union, you must comply with the EU User Consent Policy. We have added a notice of this requirement in our YouTube API Terms of Service.
November 22, 2013
This update contains the following changes:
-
The JavaScript file that you should load to add your own button has changed to https://apis.google.com/js/platform.js. The old file, https://apis.google.com/js/plusone.js will still be supported, but the new file is more efficient.
-
The subscription button attributes section now explains how to use the data-count attribute to specify whether a Subscribe Button should show the associated channel's subscriber count. The configuration options section also now shows sample buttons that show and hide the subscriber count. Finally the tool for configuring your own button also supports this setting.
-
The Subscribe Button now fires events when a user clicks the button to subscribe to a channel or unsubscribe from a channel. The new Handling events section explains how to identify a JavaScript function that listens for these events. The subscription button attributes section also explains the new data-onytevent attribute that you use to identify the event listener.
In addition, the tool that lets you configure your own button now includes an option to indicate that you want to handle these events. When that option is selected, the button code includes a sample JavaScript function for you to modify.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[[["\u003cp\u003ePaid channel information has been removed from the documentation, and users can find more details in the YouTube Help Center.\u003c/p\u003e\n"],["\u003cp\u003eClicking the Subscribe Button now redirects users to the channel page, where they can confirm or manage their subscription.\u003c/p\u003e\n"],["\u003cp\u003eThe Subscribe Button no longer supports \u003ccode\u003esubscribe\u003c/code\u003e and \u003ccode\u003eunsubscribe\u003c/code\u003e events, and the associated \u003ccode\u003edata-ytonevent\u003c/code\u003e attribute and \u003ccode\u003eonytevent\u003c/code\u003e option have been deprecated.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers must adhere to the updated YouTube API Services Terms of Service, which became effective on February 10, 2017, along with associated supporting documents.\u003c/p\u003e\n"],["\u003cp\u003eFor users in the European Union, developers must comply with the EU User Consent Policy, as noted in the YouTube API Terms of Service.\u003c/p\u003e\n"]]],["The content outlines updates to YouTube's API and Subscribe Button features. Key changes include: removal of paid channel information (2020), changing the Subscribe Button to open the channel page for subscription/unsubscription confirmation and deprecating button events (2016), publishing updated API Services Terms of Service (2016), enforcing EU user consent policy (2015), and changing the loaded JavaScript file, adding subscriber count visibility, and implementing event firing on clicks for subscription/unsubscription (2013).\n"],null,["# Revision History\n\n### November 17, 2020\n\nThis update contains the following changes:\n\n- Examples and information related to paid channels have been removed from the documentation.\n See the [YouTube Help Center](https://support.google.com/youtube/answer/7515570)\n for more details.\n\n### October 20, 2016\n\nThis update contains the following changes:\n\n- The Subscribe Button has been updated so that users do not subscribe to or unsubscribe from a channel just by clicking on a button. Now, when a user clicks on a button, the channel page associated with that button opens in a new window.\n\n - If the user was not previously subscribed to the channel, the page displays a confirmation dialog so that the user can verify the intent to subscribe to the channel.\n - If the user was already subscribed to the channel, the user can unsubscribe from the channel page.\n- The Subscribe Button no longer fires an event when a user clicks the button to subscribe to or unsubscribe from a channel. (The button had supported `subscribe` and `unsubscribe` events.) The `data-ytonevent` attribute, which could previously be used to specify an event listener, has also been deprecated.\n\n In light of this change, the [gapi.ytsubscribe.render](/youtube/subscribe/reference#Dynamic_Rendering_Example_render) method no longer supports the `onytevent` option, which could previously be used to specify an event listener.\n\n### August 11, 2016\n\nThis update contains the following changes:\n\n- The newly published YouTube API Services Terms of Service (\"the Updated Terms\"), discussed in detail on the [YouTube Engineering and Developers Blog](http://youtube-eng.blogspot.com/), provides a rich set of updates to the current Terms of Service. In addition to the [Updated Terms](/youtube/terms/api-services-terms-of-service), which will go into effect as of February 10, 2017, this update includes several supporting documents to help explain the policies that developers must follow.\n\n The full set of new documents is described in the [revision history for the Updated Terms](/youtube/terms/revision-history). In addition, future changes to the Updated Terms or to those supporting documents will also be explained in that revision history. You can subscribe to an RSS feed listing changes in that revision history from a link in that document.\n\n### December 18, 2015\n\nEuropean Union (EU) laws require that certain disclosures must be given to and consents obtained from end users in the EU. Therefore, for end users in the European Union, you must comply with the [EU User Consent Policy](http://www.google.com/about/company/user-consent-policy.html). We have added a notice of this requirement in our [YouTube API Terms of Service](/youtube/terms#notices-to-users).\n\n### November 22, 2013\n\nThis update contains the following changes:\n\n- The JavaScript file that you should load to add your own button has changed to `https://apis.google.com/js/platform.js`. The old file, `https://apis.google.com/js/plusone.js` will still be supported, but the new file is more efficient.\n\n- The [subscription button attributes](#Subscription_Button_Attributes) section now explains how to use the `data-count` attribute to specify whether a Subscribe Button should show the associated channel's subscriber count. The [configuration options](#Configuration_Options) section also now shows sample buttons that show and hide the subscriber count. Finally the tool for [configuring your own button](#Configure_a_Button) also supports this setting.\n\n- The Subscribe Button now fires events when a user clicks the button to subscribe to a channel or unsubscribe from a channel. The new [Handling events](#Handling_Events) section explains how to identify a JavaScript function that listens for these events. The [subscription button attributes](#Subscription_Button_Attributes) section also explains the new `data-onytevent` attribute that you use to identify the event listener.\n\n In addition, the tool that lets you [configure your own button](#Configure_a_Button) now includes an option to indicate that you want to handle these events. When that option is selected, the button code includes a sample JavaScript function for you to modify."]]
