Documentation Release Notes
Apps & Authentication: Getting Tokens: OIDC: Added claims and UserInfo endpoint.
Chatbots & IRC Guide: Added scopes for /vip, /unvip, and /vips commands.
Chatbots & IRC Guide: Twitch Tags: In USERNOTICE, added anonsubgift.PubSub Guide: Added sample message for anonsubgift.
Chatbots & IRC: A new document, Twitch IRC Capability: msd-ID Tags, contains a complete (lengthy) list of all
Extensions Reference: New JWT schema field,
New Twitch API Reference: New description and example in Get Webhook Subscriptions, which requires a Bearer token.
|10/24/18||Extensions Guidelines & Policies: New version of this document.|
New Twitch API Reference, New Twitch API: Webhooks Reference: Added a display-name response field to several endpoints and webhooks. Endpoints affected: Get Bits Leaderboard, Get Clips, Get Streams, Get Streams Metadata, Get Stream Markers, Get Users Follows, Get Videos. Webhooks affected: Stream Changed, User Follows.
Building Extensions: Added information about pre-release disclosures.
Apps & Authentication Guide: In “Types of Tokens,” added a clarification about bearer tokens.
New Twitch API Guide: New information in “Rate Limits.”
Getting Started with Extensions: Added the new Extensions Developer Sandbox.
Extensions: Onboarding is now required only for monetization (Bits).
Extensions: Added the new Configuration Service. See:
|10/9/18||Chatbots & IRC: Twitch Commands, Chatbots & IRC: Twitch Tags: Added CLEARMSG, single-message removal on a channel.|
Drops Guide: Added recommendations for campaigns.
Webhooks Reference: Clarified the functionality of the Stream Changed webhook (formerly called Stream Up/Down).
|10/1/18||Drops Guide: New functionality for creating and using items, with a new Item Manager page and new fields for items. See especially the section on using campaigns.|
Extensions Reference: New
Apps & Authentication Guide: The
Chatbots & IRC Guide: New section on Scopes for IRC Commands.
Mobile Deep Links: New section on launching the Twitch app with universal links (recommended).
New Twitch API: Webhooks Guide: Subscription limits have changed. Each client ID can have at most 10,000 subscriptions. Also, you can subscribe to the same topic at most 3 times.
New Twitch API Reference: New optional query string parameters (
|9/7/18||Extensions Reference: New JS helper function,
|9/6/18||New Twitch API Reference: Added new endpoints, Create Stream Marker and Get Stream Markers.|
|9/4/18||Insights & Analytics: Added three new clips fields to game-developer analytics.|
|9/3/18||Getting Started with the New Twitch API: When registering your app, the app name must not include "Twitch" (as an exact or fuzzy match), or registration will fail.|
Extensions (several docs): Added pop-out Extensions. Start reading here in Required Technical Background (this links to relevant info elsewhere in the doc set).Extensions Reference: Added Send Extension Chat Message endpoint and Twitch Extension Feature Flags (JS helper functions).
Insights & Analytics: Added Twitch Quarterly Insights (fact sheet for games).
Building Extensions (Mobile Support): Due to requirements recently communicated to us by Apple, Extensions support on iOS devices (including the ability to test on iOS) is now restricted to Apple Developer Program members.
Insights & Analytics: Added V2 of extension analytics.
New Twitch API Reference: Updated the Get Extension Analytics endpoint for V2.
New Twitch API: Webhooks Reference: Added new webhook, Extension Analytics.
|8/2/18||Chatbots & IRC: Twitch Tags: Marked some parameters as deprecated (
|7/31/18||New Twitch API Reference: Added Get Webhook Subscriptions endpoint.|
|7/27/18||Designing Extensions: Added more guidance for all extensions and panel extensions.|
Added a new Extensions document, Bits in Extensions Guide & Reference.
|7/12/18||Twitch API v5 Channel Feed Reference: Changed (deprecated) most endpoint responses.|
Extensions Guidelines & Policies: Added a note about which versions of Android and iOS must be supported by mobile extensions.
Extensions Reference: Added two new fields to the
Insights & Analytics: Added V2 of game analytics.
New Twitch API Reference: Updated the Get Game Analytics endpoint, to enable selection of report version and date/time range.
Chatbots & IRC Guide: Updated the information on "Connecting to Twitch IRC."
Building Extensions: In “Local Test,” added information about the new Invite Only tab, for seeing whitelisted extensions in the Extensions Manager.
New Twitch API Reference: Added three endpoints: Get User Extensions, Get User Active Extensions, Update User Installed Extensions.
Apps & Authentication: Added new scopes, for new endpoints.
Embedding Twitch: Everything: For the
Embedding Video & Clips: In
Drops Guide: In "Next: Notify the Viewer about Drops," added GUID to URLs.
Having Extensions Reviewed: Before you submit an extension for review, you now select a category under which your extension will be shown in the Extension Manager and upload an image for "discovery" purposes.
Getting Started docs:
Extensions Reference: Changes to Send Extension PubSub Message (messages can be sent globally),
New Twitch API Reference: Added pagination parameters and additional example to Get Game Analytics. Added Get Extension Analytics endpoint.
New Twitch API: Webhooks Reference: Added two webhooks (User Changed, Game Analytics).Insights & Analytics: New doc, with information on both game developer analytics and extensions developer analytics. (Replaces the Game Developer Analytics doc.)
|5/15/18||Getting Started with Extensions: In “Procedure for Non-Twitch Partners/Affiliates,” the last step of beginning the onboarding process was changed.|
New Twitch API Reference:
|5/2/18||The Extensions Guide was split into several, shorter docs. Look in the Extensions doc category.|
Embedding Video and Clips: In “Interactive Frames for Live Streams and VODs” > “Optional Parameter,” the default of the parameter
Extensions Guide: Video-component extensions were added. Broadcasters can activate up to six extensions at a time: 3 panel, 1 video overlay (full screen), and 2 video component (smaller). 5/2 update: Now that the Extensions Guide has been split up, this information is in Required Technical Background for Extensions.
Extensions Reference: Info was added about video-component extensions (new JS Helper function,
Embedding Video and Clips: In “Events Emitted by and Defined by the Player,” a new
Apps & Authentication Guide: See new wording in “Validating Requests.”
Embedding Video and Clips: In “Interactive Frames for Live Streams and VODs” > “Events Emitted by and Defined by the Player,” a new
Extensions Guide: In “Appendix B: Guidelines and Practices,” the policy for audio was revised: “Extensions can include audio only if they include controls which allow viewers to adjust the volume, and by default, these controls are set to off/muted.” 5/2 update: Now that the Extensions Guide is split up, this information is in Extensions Guidelines & Policies.
Extensions Reference: Changes related to the introduction of dynamic anchors. Search for “anchor” in the doc.