Twitch Extension Review Process: The Missing Manual

Sanyu Kiruluta 
Manager, Developer
Onboarding

Twitch Extension Review Process:
The Missing Manual!

TwitchCon 2018 San Jose, California
300+ Live Extensions
2039
Reviews
1304
Approvals
29%
Approved 1st Try
Twitch Extension
Review Statistics

What do we do? What
happens when we get
to the approval
process?
EXTENSION APPROVAL PROCESS
Help you understand
policyLorem ipsum dolor
sit amet,
consectetur
adipiscing elit, sed
do eiusmod
tempor incididunt
ut labore et dolore
01.
Provide clear review
guidanceLorem ipsum dolor
sit amet,
consectetur
do eiusmod
tempor incididunt
ut labore et dolore
02.
HI SANYU,
YOUR EXTENSION HAS NOT PASSED REVIEW.
YOUR EXTENSION MUST HAVE AT LEAST ONE VALID SCREENSHOT.
IF YOU HAVE ALREADY ADDED A SCREENSHOT, BUT ADDED IT AFTER
MOVING TO HOSTED TEST, PLEASE IGNORE THIS MESSAGE AND MOVE
YOUR EXTENSION BACK INTO REVIEW.
FILES & CODE REVIEW ISSUES:
• EMBEDDABLE IFRAMES ARE NOT ALLOWED WITHIN EXTENSIONS.
• ALL EXTERNAL CSS/JS MUST BE INCLUDED WITH YOUR UPLOAD
TWITCHDEV
TO ME >
WHAT? OH NO! BOOOOOOO!

What do we do? What
happens when we get
to the approval
process?
EXTENSION APPROVAL PROCESS
Help you understand
policyLorem ipsum dolor
sit amet,
consectetur
do eiusmod
tempor incididunt
ut labore et dolore
01.
Provide clear review
guidanceLorem ipsum dolor
sit amet,
consectetur
do eiusmod
tempor incididunt
ut labore et dolore
02.
HI SANYU,
CONGRATULATIONS. YOUR EXTENSION HAS BEEN APPROVED!
TWITCHDEV
TO ME >
HOORAH! YAY! AWESOME!

How are we going to do that?
- Walkthrough the Extension Lifecycle
- Discuss the the Extension Review Process
- Look at the Top 10 Extension Review Failure Reasons
- Final Tips and Tricks

Twitch Extension
Lifecycle

Extension
Lifecycle
Create Extension
dev.twitch.tv
Create
Extension
EXTENSION REVIEW PROCESS

Test Extension
- Develop and test
frontend and backend
- Submit metadata and
assets
Test /
Hosted Test
Extension
Lifecycle
Create
Extension

Submit Extension for
Review
- Metadata Review
- Policy Review
- Functional Review
- Code Review
Under
Review
Test /
Hosted Test
Extension
Lifecycle
Create
Extension

HI SANYU,
YOUR EXTENSION HAS N
YOUR EXTENSION MUST
IF YOU HAVE ALREADY AD
MOVING TO HOSTED TES
YOUR EXTENSION BACK I
FILES & CODE REVIEW IS
• EMBEDDABLE IFRAMES
• ALL EXTERNAL CSS/JS M
TWITCHDEV
TO ME >
WHAT? OH NO! BO
O!
Failed Review
- Metadata Issues
- Policy Issues
- Functional Issues
- Code Issues
Under
Review
Test /
Hosted Test
Extension
Lifecycle
Create
Extension

HI SANYU,
CONGRATULATIONS. YO
TWITCHDEV
TO ME >
HOORAH! YAY! AW
Extension Approved
- No review issues found
- Ready for go live
Under
Review
Test /
Hosted Test
Extension
Lifecycle
Create
Extension
Approved

Go Live!
- Developer has full
control release timing
Under
Review
Test /
Hosted Test
Extension
Lifecycle
Create
Extension
Approved
Released

Twitch Extension
Review Process
- Metadata Review
- Policy Review
- Code Review
- Functional Review

Metadata
Missing icon or images - No Twitch Images - Incomplete descriptions
Review

Policy Review
Extensions Guidelines, Developer Agreement, Twitch Terms of
Service, Community Guidelines, Bits Acceptable Use Policy, Oh My!

Functional Review
Is your review channel live? Is your backend up? Is your Extension
configuration easy to understand?

Code Review
Obfuscation, eval(), Missing HTML/JS files

Top 10 Extension Review
Failure Reasons

YOUR LIVE REVIEW CHANNEL IS THE MOST EFFECTIVE
WAY FOR US TO TEST YOUR EXTENSION
Number of ways you can set this up
- ffmpeg
- Include optimal review times in your
review notes
#1: Review Channel
Not Live (Functional)
Starting today, we are reducing the
number of use cases where a review
channel required

DO NOT MAKE CHANGES TO YOUR EXTENSIONS ICONS,
IMAGES, DESCRIPTION, AND CATEGORY IN HOSTED TEST
Always move your Extension back into
Test before making metadata changes
#2: Metadata Change in
Hosted Test (Metadata)
We are working on a better solution
for this!

DOUBLE CHECK YOUR MANIFEST BEFORE SUBMITTING
FOR REVIEW
- You must include Extension helper in
your asset upload to the Twitch CDN
- If you are not providing a config.html,
remove reference to it from your
manifest
#3: HTML/JS/CSS Files
Missing (Code Review)

MINIFICATION IS OK IF CODE IS STILL HUMAN-
READABLE
New Obfuscation Policy!
#4: Obfuscation
(Code Review)

YOUR DESCRIPTION SHOULD DESCRIBE
ACCURATELY AND COMPLETELY THE
FUNCTIONALITY AVAILABLE IN YOUR EXTENSION
#5: Insufficient Description
(Metadata)

You must resubmit for review if you update your
broadcaster whitelist
IF WE CANNOT REVIEW IT, WE CANNOT APPROVE IT
- Provide clear testing instructions
- Make sure your backend is live
- Use account whitelisting for pre-release testing
#6: Failed to Load
(Functional)

IF YOU DON’T HAVE THE RIGHTS TO USE THE IMAGE,
DON’T INCLUDE IT IN YOUR SUBMISSION.
#7: Unauthorized Usage of
Twitch IP (Policy)

YOUR EXTENSION CAN INCLUDE AUDIO BUT IT MUST BE
OFF BY DEFAULT, AND IT MUST PROVIDE A WAY FOR
VIEWERS TO ADJUST THE VOLUME
#8: Audio (Policy)

EXTENSIONS ARE MEANT TO ENHANCE THE
BROADCASTER AND VIEWER EXPERIENCE ON TWITCH
#9: Offsite Links to
Ads or Non-Twitch
Functionality (Policy)

REVIEW THE BITS-IN-EXTENSIONS GUIDELINES AND THE
BITS ACCEPTABLE USE POLICY
New Bits-in-Extensions Policy!
#10: Violates Bits
Usage Policies (Policy)

REVIEW THE BITS-IN-EXTENSION GUIDELINES AND THE
BITS ACCEPTABLE USE POLICY
New Bits-in-Extensions Policy!
#10: Violates Bits
Usage Policies (Policy)

Final Tips
and Tricks
- Provide a clear description &
detailed testing instructions
- Use account whitelisting for pre-
release testing
- Think BIG
- Reach out for help or advice or to
give us feedback

Twitch Extension Review Process: The Missing Manual

Twitch Extension Review Process: The Missing Manual

More Related Content

Twitch Extension Review Process: The Missing Manual