Contents

Documentation Changelog

Date Documentation Changes
2021‑06‑17

Get Channel Chat Badges - Now supports OAuth app access tokens in addition to OAuth user access tokens.

EventSub - Channel Subscription End Event added tier and is_gift.

Authentication - The existing user:read:email scope has been added.

2021‑06‑15

Twitch API endpoints added for Twitch channel stream schedule.

Channel Subscription Message has moved from public beta to v1.

2021‑06‑11

Channel Subscription Gift has moved from public beta to v1.

Get Videos updated to explicitly mention the 500 results limit when specifying game_id.

2021‑06‑08

Twitch API endpoints added for Twitch Emotes.

2021‑06‑07

Channel Subscription Message EventSub subscription type added as a public beta.

Extension Bits Transaction Create EventSub subscription type has moved from public beta to version 1.

2021‑06‑03

Channel Subscription Gift EventSub subscription type - Added is_anonymous boolean to the event.

AutoMod Queue and User Moderation Notifications PubSub topics - Examples updated for accuracy.

Several GitHub Issues resolved for documentation.

2021‑06‑02

Get Broadcaster Subscriptions - total subscription count added to the response.

2021‑05‑28

Twitch API endpoints have been added for chat badges.

EventSub subscription type updates.

2021‑05‑24

Polls and Channel Points Predictions Twitch API endpoints have moved from public beta to general availability.

Polls and Channel Points Predictions EventSub subscription types have moved from public beta to version 1.

AutoMod Queue and User Moderation Notification topics added to PubSub reference.

2021‑05‑21

Extension Bits Transaction Create EventSub subscription type has been added as a public beta.

Channel Points Custom Rewards - The API reference for Custom Rewards endpoints has been updated for consistency and to clarify conditional requirements for body parameters. For example, max_per_stream is required if a value for is_max_per_stream_enabled is also provided.

2021‑05‑14

Channel Prediction Lock EventSub subscription type - corrected the name of the lock timestamp to locked_at.

Channel Prediction End EventSub subscription type - removed the locked_at field due to edge cases with Predictions that are cancelled or closed early.

Create EventSub Subscription and Get EventSub Subscriptions - limit removed following the new EventSub subscription limit cost-based system.

Get Channel Information - Added delay to return values table and example payload.

2021‑05‑12

Manage Held AutoMod Messages – Added to the Twitch API reference.

Authentication - moderator:manage:automod scope added for Manage Held AutoMod Messages.

2021‑05‑06

Channel Subscription End EventSub subscription type has been added as a public beta.

This entry has been updated, the subscription type has been renamed from “Channel Unsubscribe” to “Channel Subscription End” after moving from beta to v1.

2021‑05‑03

Twitch API endpoints added for polls and Channel Points Predictions as a public beta.

EventSub subscriptions types added for polls and Channel Points Predictions as a public beta.

2021‑04‑30

Overview page - New information and organization.

EventSub Subscriptions Types - Added information regarding the expected availability of EventSub subscription types when released as a public beta.

2021‑04‑26

Notification Example for user.authorization.revoke updated to show the cost is 1.

Embedding Twitch - Minor documentation updates.

2021‑04‑20

Get Followed Streams - Added to the Twitch API reference.

Authentication - user:read:follows scope added for Get Followed Streams.

v5 Migration Guide - Updated to mention Get Followed Streams equivalence.

2021‑04‑15

Modify Channel Informationdelay added as an optional body parameter.

New API response fields added

2021‑04‑09

Get Broadcaster Subscriptions - Added context for how a Twitch Extension can retrieve this information.

Update User - Clarifying why description is optional and what results if not provided.

Extensions Reference - Parameter tables reordered to match the order they should be passed into their respective functions.

Other minor corrections.

2021‑04‑05

Twitch Quarterly Insights has been decommissioned and removed in favor of Game Developer Analytics.

2021‑03‑31

Viewer Heartbeat Service (VHS) v5 endpoints removed in association with the decommission of legacy Drops.

2021‑03‑30

Organizations updated to include information regarding joining multiple organizations, as well as minor updates.

2021‑03‑26

EventSub’s Channel Moderator Add and Channel Moderator Remove subscriptions types have been moved from beta to v1.

Added associated Twitch API endpoints to the scopes section of the Authentication guide.

Minor design improvements.

2021‑03‑19

Get Drops Entitlements

  • The maximum value for the number of items return via the first parameter has been increased to 1000.
  • Pagination updated for accuracy in the the return values table and the example payload.

Webhooks example payloads updated for accuracy.

Miscellaneous corrections.

2021‑03‑12

Added Check User Subscription to the Twitch API.

EventSub’s cost-based system for subscription limits has been added. Thanks for the feedback on RFC 0014.

Improved the instructions and information regarding the creation of Twitch applications for Drops campaigns.

Several documentation corrections received through GitHub Issues have been resolved.

2021‑03‑04

Twitch API

  • Get Channel Teams has been added to the API reference.
  • Get Teams has been added to the API reference.
  • The v5 migration guide has been updated to include the new Get Teams endpoint.

EventSub

2021‑02‑26

EventSub updates

The following endpoints were updated to use the channel:manage:broadcast scope. The previous scope remains valid.

Updated the v5 Video Upload Guide introduction for visitors looking for information regarding uploads via the Creator Dashboard.

Fixed broken links in chat references.

Removed the “Create Entitlement Grants Upload URL” Twitch API endpoint associated with a previous version of Twitch Drops.

2021‑02‑22

Legacy Drops have been removed following the announced decommission.

2021‑02‑19

status added to EventSub subscription objects.

Scope for Channel Subscriptions in PubSub has been updated to channel:read:subscriptions. Previous scope remains valid.

Channel Points Hackathon banner added.

Further clarification for game_id and title added for Modify Channel Information.

Minor updates to the API guide and Chat guide.

2021‑02‑12

EventSub Channel Ban v1 now includes moderator information, reason for ban, and timeout duration if the ban was a timeout.

EventSub Channel Unban v1 now includes moderator information.

Section 7.5 of the Extensions Guidelines and Policies has been removed following the original announcement.

2021‑02‑09

In EventSub, the authorization scopes allowed for all Channel Point subscription types have been updated to accept channel:read:redemptions or channel:manage:redemptions.

Updated Get Users to correctly document created_at in the example.

Minor editorial updates to the Extensions Monetization Guide.

2021‑02‑05

Eventsub API endpoints have been moved to the API reference.

A message regarding the deprecation of Twitch Quarterly Insights has been added to Insights following the recent announcement.

Explicitly stating in Extensions that files should be zipped together as opposed to zipping the directory containing the files.

Miscellaneous UserVoice and GitHub Issues addressed.

2021‑01‑29

EventSub

  • The Channel Raid subscription type has been added as a public beta.
  • The started_at timestamp has been added to the Stream Online Event.

A note about removing Extensions Policy 7.5 has been added since Twitch Extensions no longer load for banned users.

The Drops guide now includes a section regarding thoughtful naming of campaigns and rewards.

Product Lifecycle has been updated to include definitions for tagging functionality in the documentation.

2021‑01‑28

broadcaster_login and/or user_login added to multiple API endpoint payloads that already return user ID and display name.

2021‑01‑22

EventSub:

  • Corrected status value in examples.
  • Clarified requirements for secret.

Authentication updates:

  • Correctly state a 400 Bad Request is returned when attempting to revoke an invalid token, rather than a 200 OK.
  • Scope information corrections and updates.

Additional updates:

  • offset removed from Get Channel Followers endpoint in v5 as it is no longer supported. cursor should be used for pagination.
  • Extensions tutorial updated to use Gists instead of image.
  • Several UserVoice suggestions and GitHub Issues addressed.
2021‑01‑15

New Twitch API endpoints available:

The new scopes for these endpoints have also been added to Authentication. Updated the descriptions of existing scopes for consistency and accuracy.

  • channel:read:editors
  • channel:manage:videos
  • user:read:blocked_users
  • user:manage:blocked_users

v5 migration guide updates:

  • New v5 scope mappings have been added for the above endpoints. See channel_editor, channel_read, user_blocks_read, and user_blocks_edit.
  • Five endpoint equivalence definitions have been added for the above endpoints.

giantbomb_id set to 0 in the v5 Get Top Games response example to reflect a game data migration.

2021‑01‑08

EventSub updates:

  • Added support for filtering by type.
  • Added user login to notification payloads.

Added twitch://broadcast mobile deeplink to broadcast a specific category.

Embed updates:

  • enableCaptions() function, disableCaptions() function, and Twitch.Player.CAPTIONS event added.
  • sandbox added for embedded chat.
  • getPlaybackStats() function and a description of the PlaybackStats object added back into the documentation.
  • autoplay documentation updated to note the default value is false.
  • Removed frameborder and scrolling from Twitch embed examples as these were deprecated in HTML5.

Feedback and bug reports:

2020‑12‑18

Updated auth validation sample with values and the expires_in field.

Updated JavaScript helper examples to use window.Twitch.ext.

Clarifcation for linking accounts for time-based Drops.

Miscellaneous API reference fixes.

2020‑12‑17

Details for retriving ingest servers have been moved to the top-level Video Broadcasting section. This includes the launch of “Get Ingest Servers” to replace its deprecated version previously found in v5.

2020‑12‑04

UserVoice feedback fixes:

Miscellaneous fixes:

  • Removed duplicate search results
  • Displaying more search results
  • Provided the full accept header in the v5 “Requests” section
  • Changed the date format in the changelog to YYYY-MM-DD
2020‑12‑01

Added progress field to Hype Train EventSub subscription types.

2020‑11‑30

Corrections and edits to the EventSub documentation. Fixed a typo for “msg-param-gift-months” under IRC usernotices.

2020‑11‑19

Corrections and edits to the EventSub documentation.

Updated Drops Analytics image.

Changed type for pagination response field to be “object containing a string”.

Corrections and edits to scopes documentation.

2020‑11‑13

Added documentation for EventSub.

Added Channel Points API to the API Reference.

Added a v5 to Twitch API migration guide.

2020‑11‑04

Added information about Drops Analytics to documentation.

2020‑10‑29

Removed CurseForge references from docs.

API Reference:

  • Corrected token requirement for Get Stream Tags.
  • Made sub-section ordering consistent, listing query parameters before body parameters.
  • Corrected Modify Channel Information documentation which had body parameters listed as query parameters.

Pub Sub:

  • Updated user notices for multi-month subscriptions.
  • Added sample code for multi-month subscriptions.
  • Updated the topic for chat moderator actions.
2020‑10‑26

API Reference:

  • Fixed issue causing apostrophes to show as random characters.
  • Removed duplicate entry for Get Stream Tags.

Authentication Guide:

  • Added maximum OAuth token limits.
  • Added channel:read:redemptions scope.
  • Corrected the spelling of channel:manage:broadcast.

Clarified instructions for supplying parameters in the Webhooks Reference.

Clarified limits in the Webhooks Guide.

In the Extensions Guide, corrected the environment variable HTTPS=true for create-react-app.

 

2020‑10‑09

Updates to the API Reference:

  • Made example code consistent.
  • Eliminated duplicate entry for the Get Stream Tags endpoint.
  • Fixed typos.

Fixed a typo in the channel:manage:broadcast scope.

Removed the Glossary.

2020‑09‑23

Removed links to internal documents in Increase Feedback in Extensions.

2020‑09‑17

Added to the v5 API Get Channel Subscribers endpoint the information that if a user in the subscribers list has been banned, the subscription information will be provided, but the user object will have a value of null.

2020‑09‑15

Edited all documentation to replace the terms “blacklist” and “whitelist” with “denylist” and “allowlist”.

Edited and redesigned the top-level page:

  • Fixed broken links.
  • Added links to UserVoice and GitHub for feedback and support.
  • Removed outdated screenshots.
  • Removed redundant links.

Added to the Get Clips endpoint documentation that clips are returned sorted by view count, in descending order.

2020‑09‑14

Updated the following endpoints to make clear they are about Bits codes:

Updated Extensions documentation to say that layout needs to accommodate variable height rather than fixed at 700 pixels.

2020‑09‑12

Added discussion of subscription status support to the Extensions Monetization documentation.

Clarified language in the Create Clip endpoint documentation.

2020‑09‑07

Documented authentication and Join rate limits for chat.

Removed documentation for chat rooms, because the feature is deprecated.

 

 

2020‑08‑28

Removed mention of a webhook for Drops because it is not yet available.

2020‑08‑25

Updated the API Reference to note that the clips service returns a maximum of 1000 clips.

Removed the deprecated information about rate limits when there is no token from the API Guide.

Added pagination information to the Get Drops Entitlements endpoint documentation.

2020‑08‑21

Fixed code sample for Events-based Drops.

2020‑08‑20

Updated Authorization section for the Get Clips endpoint to indicate that a user access token is required.

2020‑08‑18
2020‑08‑13

Added a new section to our Extension Submission Best Practices: Template for a helpful Walkthrough Guide and Change Log

2020‑07‑30

Updated Marketing and Developer User Roles.

2020‑07‑30

Updated Webhooks documentation to describe notification timeout.

Changed documentation of Start Commercial response field from retryAfter to retry_after.

2020‑07‑23

Updated Extensions documentation to reflect new process for required review channels.

2020‑07‑21

Addressed issues in the API reference for the following endpoints:

2020‑07‑06

Added required authorization for the Get Streams endpoint and updated sample code.

2020‑07‑01

Added new fields to the Channel Subscriptions Event Pubsub topic and a new USERNOTICE tag parameter in support of Multi-Month Subscription Gifting.

2020‑06‑22

Updated the Authentication Guide to mention that developers can provide multiple redirect URIs.

2020‑06‑22

Bug fixes in the API Reference.

2020‑06‑18

Added new endpoints to the API Reference and Webhooks Reference:

  • Get Channel Information
  • Modify Channel Information
  • Search Channels
  • Search Categories
  • Get Stream Key
  • Start Commercial
  • Create User Follows
  • Delete User Follows
  • Get Cheermotes

Added new functionality to the API: the Hype Train API.

2020‑06‑15

Added links to rate limits documentation to the API Reference.

2020‑06‑03

Clarified the definition of Subscription denied in the Webhooks Guide.

2020‑05‑12

Removed documentation of MODE and NAMES in the IRC documentation because they have not functioned correctly for some time and will not be supported.

2020‑05‑08

Drops Guide: Updated Create Entitlement Grants Upload URL example to include Client ID.

API Reference: Updated all example requests to include Client ID and token in Authorization header, as per new OAuth requirement.

2020‑05‑04

Fixed a bug in the API Reference. The optional scope for the Get Users endpoint should be user:read:email.

2020‑05‑01

Updated the Twitch API Reference to reflect that OAuth is now mandated.

Updated the Authentication Guide to include new OAuth scopes. 

Updated the Webhooks Reference to show that authorization is now required authorization for every web hook.

2020‑04‑27

Updated Extensions Best Practices: 

Updated the Extensions Guidelines and Policies page for Content and Commerce.

2020‑04‑20

Updated Drops documentation to align with UI changes.

2020‑04‑01

Deleted documentation of these deprecated v5 endpoints: 

  • Get Channel Communities
  • Set Channel Communities
  • Delete Channel from Communities

Corrected URL for Get Extension Transaction endpoint.

2020‑03‑30

Updated definition of “language” in v5 Streams API Reference.

2020‑03‑27

Published new Extensions Guide.

2020‑03‑18

Updates to the Embedding Twitch documentation: 

  • Added new parent parameter.
  • Removed deprecated getPlaybackStats method.
  • Removed references to the font-size option for everywhere embeds.
2020‑03‑10

Updated the Extensions Guidelines & Policies to add Moderation.

2020‑02‑25

Edited the following endpoints in the v. 5 API Reference:

Edited the Get Game Analytics endpoint to note that we only return data for the previous 365 days.

Updated documentation for the sunset of Premieres.

2020‑02‑14

Updated the game_id parameter in the Get Streams endpoint from up to 100 IDs to up to 10 IDs.

Documented the isBitsEnabled feature flag in the Extensions Reference.

Removed the link to the deprecated form to increase webhook subscription limits.

Added gifter_id and gifter_name fields to the Get Broadcaster Subscriptions endpoint and webhook.

2020‑02‑13
  • Removed the live query string parameter from the Search Games endpoint documentation.
  • Removed the popularity response field from the Search Games and the Get Top Games endpoint documentation.
2020‑01‑24

Updates to PubSub documentation

  • Added Chat feature
  • Added Required Scope for channel-bits-events-v1 and channel-bits-badge-unlocks
  • Removed channel-commerce-events-v1 because it is deprecated
2020‑01‑10
  • Updated documentation to reflect that OAuth is the preferred method of authentication.
  • Removed documentation for chat rooms because the feature is deprecated.
2020‑01‑08

Extensions tutorials are now live on the site.

2019‑12‑17

Webhooks Reference

  • Updated description of Subscribe / Unsubscribe call to be more accurate about response codes and authentication required.
  • Small syntax / formatting tweaks in the JSON examples.
  • Mention the authenticated scopes needed for various authenticated webhooks.

Webhooks Guide

  • Clarified how retries are performed and how we handle non-2xx response codes from clients.
  • Provided insight into the implementation of a handler for verification according to the W3C websub spec.
2019‑12‑16

Added the Channel Points PubSub topic.

2019‑12‑05

Added chat rooms to the Product Lifecycle page as deprecated.

2019‑12‑02

Updated the Getting Tokens OIDC doc to note that the email and email_verified claims will soon be gated by user:read:email scope.

2019‑10‑22

Updated review section in Extensions Life Cycle Management doc to include review SLA.

2019‑10‑16

Added Product Lifecycle page to the site.

2019‑09‑28

Added links to the Developer Rig in these pages: 

2019‑09‑11

Added Increasing Feedback in Extensions.

2019‑09‑10

Removed communities-related data fields from Get Streams and Get Streams Metadata endpoints. These fields are no longer supported.

Merged Get Broadcaster’s Subscribers into Get Broadcaster Subscriptions because they both return the subscribers to a channel. 

Added Load Testing Extensions Using Locust and Elastic Beanstalk document.

Added Submission Best Practices for Extensions.

2019‑09‑06

Corrected msg_id parameter type in Check AutoMod Status from integer to string.

2019‑09‑04

Added an updated Glossary.

2019‑08‑22

Edited the payload example in Topic: Subscription Events.

2019‑08‑14

Edited optional Create Stream Marker parameter description to include a max length of 140 characters.

Removed “Increasing Feedback in Extensions”.

2019‑08‑07

Update Mobile Deep Links

2019‑08‑05

Updated Organizations (formerly “Companies”).

Updated Extensions: Developer Rig

Updated Extensions: Increasing Feedback in Your Extension.

2019‑08‑04

Add RBAC info to “Companies” (now “Organizations”)

2019‑07‑31

Added 2.10 and 2.11 to Extensions Guidelines and Policies.

Updates to “Extensions: Designing” guide.

2019‑07‑30

Add RBAC information to Extensions Life Cycle Management and Monetization. 

2019‑07‑29

Corrected URL for endpoint Get Moderator Events.

2019‑07‑22

Extensions update - reset file ordering

2019‑07‑19

Retry adding 3 new Extensions docs (A/B Testing, Google Analytics, & Increasing Feedback)

2019‑07‑18

DA-430: Add three new Extensions documents: Using A/B Testing in Extensions, Using Google Analytics in Extensions, and Increasing Feedback in Extensions. Also made minor change in Drops (meaning of “retries”).

2019‑07‑09

Updated “Chatbots & IRC” docs (Getting Started, Guide, Membership, Commands, Tags, & Chat Rooms), except for “msg-ID Tags”.

Updated all “Embed” docs (Introduction, Embed Chat, Embed Video & Clips, & Embed Everything).

2019‑06‑27

Added documentation for Get Subscription Events endpoint.

Added documentation for Subscription Events webhook.

2019‑06‑25

Documented the new Moderation API.

Documented two new webhooks:

2019‑06‑21

Insights & Analytics updates (twice today)

2019‑06‑20

Changed “position” to “policies” in Extensions: Guidelines and Policies, section 6.6.

2019‑06‑19

Added clarification to the Get Users endpoint in the Twitch API Reference that the limit of 100 IDs and login names is a total limit, not 100 of each.

Changes to Helper Bits in the Extensions Reference:

  • The field should be “exp” rather than “expires”.
  • Documented the domainID object.
  • Edited definition of the product object.
2019‑06‑13

Extensions Life Cycle Management: Added section on Control Security Policy (CSP)

2019‑06‑07

Removed deprecated Channel Feed API Reference.

2019‑06‑06

Extensions Guidelines & Policies:

  • Added policy 6.2.8.
2019‑06‑04

Added Get Extension Transactions to the Twitch API Reference.

Added Extension Transaction Created to the Webhooks Reference.

2019‑05‑30

Updated v5 API Guide: New third-party development will be limited to the API versions Kraken v5 and Helix. Limitation of new development will be enforced on client ID created on or after 5/31/2019.

2019‑05‑08

Removed orphan Bits Code Redemption Guide and added the content to the API Reference.

Fixed date errors in the changelog.

2019‑05‑07

Fixed code formatting errors in several endpoints.

Updated Configuration Service documentation.

Removed Topic: Extension Analytics and Topic: Game Analytics from the Webhooks Reference because the endpoint is returning invalid data.

2019‑04‑19

Removed note that Webhooks parameters must appear in alphabetical order because that restriction no longer exists.

Extensions Guidelines & Policies:

  • Added policies 1.5, 3.4, and 4.6.2.
  • Appended 4.3 to mention Emotes usage and beta program.
  • Appended 4.4 to mention advertising beta program.
  • Removed 4.6.1 (Off-site links must be related to the extension’s core functionality).
  • Removed 4.6.3 (Off-site links must be included within your URL allowlist).
  • Previous 5.2 and 5.3 reworked and appended to mention the commerce beta program.
2019‑04‑18

Updated link to download the Developer Rig for Windows.

Updated the v5 API Reference to indicate that the version is deprecated.

2019‑04‑16

Deleted Communities Reference from v5 API because it is deprecated.

2019‑04‑15

Video: Updated Video Upload Guide and Video Reference to note that you must be a Partner or Affiliate to upload VODs.

2019‑03‑27

Chatbots & IRC: Twitch Tags: Added note that undocumented tags can be added/removed at any time. Also, tags may appear in any order. So, developers should write code to parse tags individually and ignore unrecognized tags.

2019‑03‑26

Chatbots & IRC: Twitch Tags: Added new badge-info parameter to GLOBALUSERSTATE, PRIVMSG, USERNOTICE, and USERSTATE.

2019‑03‑18

Getting Started with Extensions and Extensions Developer Rig: Changes based on the new Developer Rig UI. Updated “Hello World” example in Getting Started.

2019‑03‑15

Extensions Reference: Added information related to Monetization.

Extensions Monetization Guide{: target=”_blank” (formerly Bits in Extensions), Extensions Life Cycle Management: Added Monetization tab to Extensions manager, for selecting Bits support and/or new subscription status support, and for going to the monetization onboarding process.

2019‑03‑14

Websub: Updated documentation to make it clear that the order of query parameters matters.

Bits: Small edits to documentation, for clarity.

2019‑03‑11

Chatbots & IRC: Twitch Tags: Added several more msg-param parameters (for USERNOTICE).

2019‑03‑08

Chatbots & IRC: Twitch Tags: Deleted broadcaster-lang (from ROOMSTATE). Added several more valid values for the msg-id field (for USERNOTICE).

2019‑03‑07

Extensions doc set: Many changes. New version of Getting Started with Extensions. New Extensions manager UI (see Extensions Life Cycle Management).

2019‑02‑21

Insights & Analytics: Added mod author analytics.

2019‑02‑08

PubSub: Added topic channel-bits-events-v2. Removed deprecated months field. Added new cumulative-months and streak-months fields.

2019‑02‑04

Chatbots & IRC: Twitch Tags: For USERNOTICE, added three fields (msg-param-cumulative-months, msg-param-should-share-streak, msg-param-streak-months) and changed when msg-param-months is sent.

2019‑01‑30

Apps & Authentication: Added the scope channel:read:subscriptions.

New Twitch API Reference: Added new endpoints: Get Broadcaster Subscriptions and Get User Subscriptions.

2019‑01‑28

Apps & Authentication: Clarified language around deprecation of Twitch API v. 5.

Getting Started with Extensions: Clarified using the native Developer Rig (beta).

2019‑01‑22

Extensions Reference: Added locale parameter to “Client Query Parameters.”

2019‑01‑18

Extensions Developer Rig: Added section on “Enabling 2FA.”

2019‑01‑17

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.”

2018‑12‑21

Getting Started with Chatbots & IRC: New version of this doc.

2018‑12‑19

Extensions Guidelines & Policies: New version of this doc.

2018‑12‑17

Code Redemption API: New reference document.

2018‑11‑30

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.

2018‑11‑28

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.

2018‑11‑27

Getting Started with Extensions, Extensions Developer Rig: Deleted information about the Developer Rig “local mode” (no longer available).

2018‑11‑14

Apps & Authentication: Getting Tokens: OIDC: Added claims and UserInfo endpoint.

Chatbots & IRC Guide: Added scopes for /vip, /unvip, and /vips commands.

Chatbots & IRC: Twitch Tags: In USERNOTICE, added anonsubgift.

PubSub Guide: Added sample message for anonsubgift.

2018‑11‑02

Twitch IRC Capability: msd-ID Tags: This new document (under Chatbots & IRC) contains a complete (lengthy) list of all msg-id tags that apply to the NOTICE (Twitch Commands) and NOTICE (Twitch Chat Rooms) commands.

Extensions Reference: New JWT schema field, is_unlinked.

New Twitch API Reference: New description and example in Get Webhook Subscriptions, which requires a Bearer token.

2018‑10‑24

Extensions Guidelines & Policies: New version of this document.

2018‑10‑23

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. 3/7/19 update: Moved to Extensions Life Cycle Mangement.

2018‑10‑22

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.

2018‑10‑16

Extensions: Onboarding is now required only for monetization (Bits).

2018‑10‑10

Extensions: Added the new Configuration Service. See:

  • Building Extensions: New “Configuration Service” section.
  • Extensions Reference:
    • Three new endpoints (Set Extension Configuration Segment, Get Extension Channel Configuration, Get Extension Configuration Segment).
    • New Twitch Extensions configuration helper functions (see “Helper: Configuration”).
    • Change to when Set Extension Required Configuration can be used.
  • Extensions Developer Rig: New Configuration Service tab.
  • Releasing & Maintaining Extensions: Many updates. 3/7/19 update: Renamed Extensions Life Cycle Management.

Insights & Analytics: Added printing a poster view of Twitch Quarterly Insights.

2018‑10‑09

Chatbots & IRC: Twitch Commands, Chatbots & IRC: Twitch Tags: Added CLEARMSG, single-message removal on a channel.

2018‑10‑02

Drops Guide: Added recommendations for campaigns.

Webhooks Reference: Clarified the functionality of the Stream Changed webhook (formerly called Stream Up/Down).

2018‑10‑01

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.

2018‑09‑28

Extensions Developer Rig: New document focusing on the rig. Also see changes to the Developer Rig section of Getting Started with Extensions.

Extensions Reference: New hostingInfo property in the onContext JS helper function. New onHighlightChanged JS helper function.

Apps & Authentication Guide: The chat_login scope is deprecated. See the section on new scopes for chat and PubSub.

Chatbots & IRC Guide: New section on Scopes for IRC Commands.

Mobile Deep Links: New section on launching the Twitch app with universal links (recommended).

2018‑09‑14

New Twitch API: Webhooks Guide: There are changes to subscription limits. Each client ID can have at most 10,000 subscriptions. Also, you can subscribe to the same topic at most 3 times.

2018‑09‑11

New Twitch API Reference: New optional query string parameters (started_at and ended_at) for Get Clips.

2018‑09‑07

Extensions Reference: New JS helper function, minimize. See Helper: Actions

2018‑09‑06

New Twitch API Reference: Added new endpoints, Create Stream Marker and Get Stream Markers.

2018‑09‑04

Insights & Analytics: Added three new clips fields to game-developer analytics.

2018‑09‑03

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.

2018‑08‑30

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).

2018‑08‑21

Insights & Analytics: Added Twitch Quarterly Insights (fact sheet for games).

2018‑08‑13

Building Extensions: 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. See “Mobile Support.”

  • If you have released a mobile extension: Your extension no longer appears on iOS. Twitch will contact you soon about adding iOS support.
  • If you develop a new mobile extension for iOS, please set up an Apple developer account (if you do not already have one), then contact Twitch (developer_support@twitch.tv) to add iOS support.

Extensions Reference: In Helper: Extensions, added new property (arePlayerControlsVisible) to the onContext JS helper function.

2018‑08‑07

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.

2018‑08‑02

Chatbots & IRC: Twitch Tags: Marked some parameters as deprecated (subscriber, turbo, and user_type). Use the badges parameter instead.

2018‑07‑31

New Twitch API Reference: Added Get Webhook Subscriptions endpoint.

2018‑07‑27

Designing Extensions: Added more guidance for all extensions and panel extensions.

2018‑07‑20

Apps & Authentication: GuideGetting Tokens: OAuth, & Getting Tokens: OIDC: Added token_type parameter (required value = bearer) in several places.

2018‑07‑19

Bits in Extensions: New document.

Extensions Guidelines & Policies: Added Bits in Extensions requirements.

2018‑07‑12

Twitch API v5 Channel Feed Reference: Changed (deprecated) most endpoint responses.

2018‑07‑06

Getting Started with Extensions, Building Extensions: Added information about the Twitch Developer Rig “local mode” (for local testing against mock, non-production endpoints).

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 onContext JS helper function (isMuted, volume).

Apps & Authentication: Split this large document into several smaller docs, to make it easier to read and find information.

2018‑06‑22

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.”

2018‑06‑19

Extensions Reference: Expanded the definition of onPositionChanged JS helper function.

Building Extensions: In “Local Test,” added information about the new Invite Only tab, for seeing allowlisted 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 layout parameter, changed the valid value from video-and-chat to video-with-chat.

Twitch API v5: In “Which API Version Can You Use?” indicated that there is no scheduled deletion date for v5.

2018‑06‑07

Embedding Video & Clips: In setVideo, added a new Timestamp parameter.

Drops Guide: In “Next: Notify the Viewer about Drops,” added GUID to URLs.

2018‑06‑04

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. 3/7/19 update: This document was deleted; information is in Extensions Life Cycle Management.

2018‑05‑31

Getting Started docs:

Extensions Reference: Changes to Send Extension PubSub Message (messages can be sent globally), listen and send JS Helper functions, and Example JWT Payload.

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.)

2018‑05‑21

Embedding Twitch and Chatbots & IRC: These large documents were spit into several smaller docs, to make it easier to read and find information.

Extensions Reference: The onVisibilityChanged JS helper function now works with component extensions.

2018‑05‑15

Getting Started with Extensions: In “Procedure for Non-Twitch Partners/Affiliates,” the last step of beginning the onboarding process was changed.

2018‑05‑09

New Twitch API Reference:

  • In Create Clip, an optional query string parameter was added, has_delay. This adds a delay before the clip is captured to account for the brief delay between the broadcaster’s stream and the viewer’s experience of that stream.
2018‑05‑02

Extensions: The Extensions Guide was split into several shorter docs. Look in the Extensions doc category.

2018‑04‑29

Updated Organizations documentation. 

2018‑04‑19

Embedding Video and Clips: In “Interactive Frames for Live Streams and VODs” > “Optional Parameter,” the default of the parameter playsinline parameter was changed to true.

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).

Extensions Reference: Info was added about video-component extensions (new JS Helper function, onPositionChanged).

New Twitch API Reference: In Get Clip, 4 query params were added (broadcaster_id, game_id, before, after).

2018‑04‑04

Embedding Video and Clips: In “Events Emitted by and Defined by the Player,” a new  Twitch.Player.PLAYBACK_BLOCKED event was added.

New Twitch API Reference: A “Resource” column was added to the summary table of endpoints, then endpoints in the doc were re-ordered to match the table (so endpoints for the same resource are in the same part of the doc).

2018‑03‑29

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 PLAYING event was added and the definition of the PLAY event was changed.

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/18 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.