|Note: Beginning in Q3 2019, you have been able to collaboratively manage Extensions. This document reflects the resulting changes in the Console.|
This guide explains how to register a Developer Organization, which enables you to manage games and build Extensions in collaboration with other Twitch Developers. Organizations also have the ability to claim games on Twitch to manage game metadata (e.g., box art), get access to game analytics, and use the Drops product. For more about claiming games, see Game Management below.
Registering an organization
Before you start to manage games or build Extensions collaboratively, you must register your organization with Twitch. An organization (also known as a company) is loosely defined as a group of one or more people who have Twitch accounts and work together. Different users in an organization can have different roles, with each role providing a different level of control over a different aspect of the Twitch experience. The concept of an organization is especially useful for large groups with multiple teams, each of which needs access to different products on the Twitch console.
|Note: You must register an organization, even if you’re the only one in it.|
Twitch Developers within an organization can be assigned these roles:
|Role||Product Management||User Management|
|Owner||Can manage games, access Game analytics, edit box art, and drop campaigns. Can manage Extensions.||Can add and delete users of any role.|
|Administrator||Can manage games, access Game analytics, edit box art, and drop campaigns. Can manage Extensions.||Can add and delete managers, marketers, and developers.|
|Billing Manager||Can manage games, access Game analytics, edit box art, and drop campaigns. Can manage Extensions, including assigning themselves or other billing managers as payout entities for Extensions.||Can add and delete managers, marketers and developers.|
|Manager||Can manage games, access Game analytics, edit box art, and drop campaigns. Can manage Extensions.||Can add and delete marketers and developers.|
|Marketer||Can access drop campaigns. Can also do anything as Developers, such as managing Extensions and Apps.||—|
|Can manage games, access Game analytics, edit box art, and drop campaigns. Can manage Extensions and Apps.||—|
How to register an organization
Note: Twitch can process only one organization registration at a time. To register an organization:
- Go to your Twitch developer console:
a. If you’re logged in, go to the console.
b. If not, go to Twitch TV, then click Your Console (top right).
- On the console homepage, you can click the CTA to register an organization. You can also click Create Organization on the top navigation.
On the registration page, fill out all fields:
Field Description Organization Name Name of your organization. Organization URL URL of your organization’s website. If you are providing games you would like to claim below, the organization URL domain must match the contact email domain, or your registration request will be rejected. Organization Type Developer, Publisher, or Other. Games Titles of games that your organization owns. Start typing and the form provides an auto-complete drop-down list of games known to Twitch. Industry Examples: e-sports, gaming, health care, energy. What is the current size of your organization? Number of people in your organization. City, State, Country Location of your organization. First Name, Last Name, Title, Email Contact information for the creator of the organization. This user is added to the organization as the owner. The email domain must match the organization URL domain, or your registration request will be rejected. What products are you interested in? Indicate which Twitch products you want to manage; for example, creating Drops, managing game box art, or accessing game Insights. What brought you to Twitch? Fill in as appropriate.
- Click Submit. The button is clickable only after all fields are filled in (and assuming you do not have another registration submission in process). After you submit, a note appears, indicating your registration is pending.
- Processing typically takes 2-3 business days, then you get an email:
- If your registration is approved, you are added to the organization as an administrator and you can manage the other users in the organization.
- If your registration is rejected, you get an informative email. The most common reasons for rejection are: the organization URL and email domains do not match (if you are claiming a game), or the organization does not own the specified game(s). Please fill out the form again, correcting the error(s), and resubmit.
Why was my organization request rejected?
We intend for organizations to be a tool for developers, game publishers and studios, or for brands that work with Twitch solutions or products. We reserve the right to reject any organization request for any reason. Here are some common reasons why a request is rejected:
- The organization name is too similar to an existing organization.
- We could not verify your ownership of any games claimed along with the application.
- If you have claimed a game, the organization URL does not match the email domain associated with your Twitch profile.
If you believe your application was rejected in error, please post a topic to our forums and a moderator and member of Twitch staff will be able to help. We apologize for any trouble!
How to manage users
To manage users:
- Ensure that any account you want to assign to a user role has a Twitch ID.
- Navigate to the console for your organization using the drop down in the navigation bar.
- Click the Manage Members button on the Organization console homepage.
- On this page, you can filter by member name and by role. You can also sort by member name, role, and the date they were added to the organization.
To add a user:
- Click the Add User button.
- Search for the Twitch username of the user.
- Provide the user’s name, title, and e-mail.
- Select the role in which the user will be placed. If selecting billing manager, see Restrictions on Billing Managers below.
- Click Add User. If not already in your organization, the user will be added and will be able to access the organization console after login.
To change a user’s role as an owner or administrator:
- Click Manage for the user who will receive the role adjustment.
- Select their new role in the drop down. If selecting billing manager, see Restrictions on Billing Managers below.
- Click Save. The role adjustment will occur immediately.
To delete a user, click the trash can to the right of the user’s name.
Restrictions on billing managers
Billing managers are Twitch account holders (or entities) that are eligible to receive Extension revenue payouts from Twitch. To be assigned this role, the Twitch account must:
- Have 2FA authentication enabled on the account. This can be done via the settings page on a Twitch account on twitch.tv.
- Completed Extensions Developer Onboarding. As Extension monetization within organizations is in limited preview, you will need to complete onboarding via the account’s personal console. In the future, we will enable onboarding via the organization console. To complete Extension Developer Onboarding:
- Login to the Developer Console with the account you wish to make a billing manager.
- Navigate to an Extension with this account. If you do not have an Extension, create a new one. Use placeholder values and skip any optional fields required when creating the first version of this Extension.
- This new Extension does not have to be used beyond the purpose of completing onboarding. Extensions you wish to manage collaboratively should be created within your Organization console.
- On any Extension (either the one you have created, or an existing Extension for that account), select a version in local test.
- Navigate to the monetization tab. Click the “Start Onboarding” button.
- If the button shows “In Progress,” continue through to the onboarding screen and follow the prompts.
- If the button shows “Onboarding Complete,” your account should be eligible for the billing manager assignment within an organization.
- On this screen (located on the main twitch.tv website), you will have a series of steps to complete that ask for payout details. Complete the steps as appropriate for your organization’s accounting (or for yourself).
- You can verify completion by returning to the monetization tab of an Extension version and observing that you can enable bits and subscription features on the Extension within the personal console.
As a game publisher or developer, you can claim ownership of your game on Twitch.tv, allowing you to manage how it is displayed on the site, as well as view game developer insights (see Insights and Analytics). You can claim ownership of a game either via the registration form, or by clicking add game within the “games” tab or on the homepage of the Organization Console.
|Note: Game ownership requests are verified within one week along with your request to create a new organization. The review team makes every effort to verify ownership using public information, but ownership requests can be denied if this is not possible. You can help our team by ensuring the Organization URL is accurate, that its domain matches your email domain, and that the information in the form can be cross-referenced with a verifiable source such as Giantbomb.com.|
Editing box art
As an owner of a game, you may change the box art displayed on the Twitch.tv directory. Here are a few guidelines you must follow:
- Frequency of changes: Box art should only be changed once every 30 days, and changes will take up to 24 hours to fully propagate on the site.
- Size limitations: Box art must be less than 1 MB at a fixed resolution of 600x800 pixels.
- Art requirements: Box art must be stripped of any logos or extraneous information aside from the game art and name of the game itself – any ESRB ratings, regulatory or similar information should be removed.
- Terms of service: Please review the Twitch Community Guidelines and Twitch Terms of Service. Any box art that violates these guidelines will not be approved.
Changes to other elements of your game’s presence on Twitch, including banner art or the name, must be submitted via a support request.
Accessing game developer insights
As the owner of a game, you can access daily and quarterly insights on your game’s activity on Twitch. To learn more, see Insights and Analytics.
Extension monetization within an organization
Organization owners can specify, on a per Extension basis, where any payouts will be received.
|Note: If you have an existing Extension (with or without monetization enabled), our support team can migrate this Extension to your organization. The owner of the Extension must have a permission level of admin or higher in the destination organization.|
After adding a billing manager (see the previous steps), follow these steps to enable monetization on an Extension:
- Navigate to an Extension. On either the version listing page or the page of a specific version, click the Extension Settings button, under the main navigation bar.
- Near the bottom of this page, you can attach a billing user to the organization. This is required to monetize the Extension.
- Only users set as a billing manager will appear in this drop down. The owner may also appear in this drop down, however, if the account has satisfied the conditions of the billing manager role (i.e., has 2FA enabled on the account and has completed Extensions Developer Onboarding).
- Once you have made your selection, click the Set Billing Manager button.
- Navigate to the latest version of an Extension. Then, select the Monetization tab.
- You can now set monetization options for the Extension.