Documentation Release Notes
|1/22/19||Extensions Reference: Added |
Extensions Developer Rig: Added section on “Enabling 2FA.”
New Twitch API Reference: Added new endpoints: Replace Stream Tags, Get Stream Tags, and Get All Stream Tags. Updated Get Streams endpoint to document new tags functionality.
Mobile Deep Links: Added deep links for category tags and live-stream tags.
Insights & Analytics: Several clarifications, based on user feedback. Revised definitions of data fields that use device IDs. New section on “Counting Device IDs.”
New version of Getting Started with Chatbots & IRC.
|12/19/18||New version of Extensions Guidelines & Policies.|
|12/17/18||Added the Code Redemption API reference.|
|11/30/18||Extensions Reference: Moved Bits-related reference information (JS helper functions) here, to consolidate all Extensions reference info in one place. The Bits in Extensions document is now purely a guide.|
Company Management: New document on registering companies and managing users in them. Company registration is required before you can manage games on Twitch or create Drops campaigns.
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 Helper: 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.
Extensions Reference: In Helper: Extensions, added new property (
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.
|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."
Extensions Reference: Expanded the definition of
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.