Setting Up User Accounts

The Users and Roles section in iTunes Connect allows a user with an Admin role to set up three types of users:

If your organization is small, the first user—the team agent—might be the only user for the organization.

If your organization requires additional iTunes Connect users, the user accounts need to be created from inside iTunes Connect. The team agent can create the additional users or can create a user with an Admin role who can create additional users.

To perform the tasks in this section, sign in to iTunes Connect as the team agent or other iTunes Connect user with an Admin role, and click “Users and Roles.”

../Art/UsersAndRolesIcon_2x.png

iTunes Connect Users

Each member of your organization who needs access to app information should have an iTunes Connect account.

What Is a Team Agent?

The person who registers for an Apple Developer Program and receives access to iTunes Connect becomes the team agent for an organization.

There are actions that only the team agent can accomplish:

  • Creating at least one additional iTunes Connect user for this organization, if needed

  • Requesting and agreeing to contracts

  • Requesting promo codes to provide free copies of a paid app to users

  • Transferring apps between organizations

  • Deleting apps from iTunes Connect

You can tell which user is the team agent because the team agent is the only user in your organization with the Legal role.

../Art/LegalUser_2x.png

iTunes Connect and Apple IDs

iTunes Connect accounts use an Apple ID as the account user name. In some cases, iTunes Connect creates an Apple ID for new users:

  • No existing Apple ID. If a person doesn’t already have an Apple ID, iTunes Connect creates an Apple ID using the information supplied for the iTunes Connect account.

  • Existing Apple ID. If a person already has an Apple ID and you use the email address corresponding to the Apple ID to set up the person’s iTunes Connect account, iTunes Connect associates the existing Apple ID with the new iTunes Connect account.

  • Existing Apple ID already associated with iTunes Connect. If a person’s Apple ID is already associated with another iTunes Connect organization, the user needs to provide a distinct email address that can be associated with the new organization; iTunes Connect creates an additional Apple ID for the user.

Users make updates to their names or email addresses through their Apple ID.

Setting Up an iTunes Connect User

Create an iTunes Connect user account for each person who needs to have access to your iTunes Connect organization. Only iTunes Connect users with an Admin role can create other iTunes Connect users or modify users’ roles or notifications.

bullet
To add a new iTunes Connect user
  1. As the team agent or other iTunes Connect user with an Admin role, sign in to iTunes Connect.

  2. On the iTunes Connect homepage, click Users and Roles.

    ../Art/UsersAndRolesIcon_2x.png
  3. Click the plus sign. If it doesn’t appear, you don’t have access to create iTunes Connect users. The team agent, or an Admin user, needs to create the new user or update your roles to allow you to create new users.

    ../Art/AddNewUseriTC_2x.png
  4. Enter the individual’s user information: first name, last name, and email address.

    The email address specified must be valid to activate the account. The user receives an email as a confirmation.

  5. Click Next.

  6. Review the email address of a user with an existing Apple ID.

    If the email address you entered is already associated with an Apple ID, a warning message appears asking you to confirm that you want to associate this Apple ID with iTunes Connect.

    Click Next to continue creating the user account with the existing email address and associated Apple ID.

    ../Art/Users-SS4_2x.png

    You can instead change the email address to create a new Apple ID. See iTunes Connect and Apple IDs.

  7. Select the roles to assign to this user.

    Roles give access to iTunes Connect sections. For example, the Admin role gives a user access to create and update material in all sections except Agreements, Tax, and Banking. The available roles are listed in User Roles.

    Only the initial iTunes Connect user (the team agent) has access to the Legal role.

  8. Click Next.

  9. Select the notification types assigned to this user by territory.

    Notifications specify which email alerts a user receives. You can set notifications by the type of change and by the territories that the change affects. For example, if an iTunes Connect user wants information about the apps that become Ready for Sale in a specific territory, you would set that user’s notifications for App Status in the specific territory, such as Canada or India. The available notifications are listed in User Notifications.

  10. Click Save.

  11. A confirmation line appears stating that verification email has been sent.

The new user receives an email from the iTunes Store that includes a link to activate the account. (Make sure to have the user check spam and junk mail filters if the activation email doesn’t arrive.)

If the account was created with an existing Apple ID, the user is asked to sign in to iTunes Connect.

If iTunes Connect created a new Apple ID for the user, the user is asked to enter a password and create a security question and answer. Then iTunes Connect opens.

Users can manage their own Apple IDs and passwords from the iTunes Connect Sign In page.

Viewing, Editing, and Deleting iTunes Connect Users

All iTunes Connect users (except users with only a Marketing role) can view the settings for all other iTunes Connect users in their organization. However, users with an Admin role are the only ones who can delete or modify user accounts, including setting roles and notifications.

Admin users can’t edit the iTunes Connect user details for the team agent (the Legal role). Team agents manage their own details.

bullet
To view your own iTunes Connect user account
  • Select Personal Details from your user name menu that appears in the top-right corner of any iTunes Connect page.

    ../Art/PersonalDetails_2x.png
bullet
To view or edit an iTunes Connect user
  1. In the “Users and Roles” pane, click iTunes Connect Users.

  2. Find the user you want to view. If the user name is not immediately visible, you can use any of the following techniques to locate it.

    • Sort the list. You can sort by last name or Apple ID by clicking the appropriate column header.

    • Search the list by entering text in the search box. The list will display all users containing that text in their names, Apple IDs or roles.

      ../Art/Users-SS6_2x.png
    • Use the filter menu to display only users with a particular role.

      ../Art/Users-SS7_2x.png
  3. If you want to make changes to the user’s details, click the Apple ID to display their User Details.

    The Apple ID link is active for clicking only if your user account has an Admin role.

  4. Make any needed changes to the user’s roles, notifications, or both.

    • To change the user’s role, click the Roles tab and select the new role; see User Roles.

    • To change the user’s notifications, click the Notifications tab and select the new notifications and territories; see User Notifications.

  5. Click Save.

  6. If you want to delete the user from the User Details page, click Delete User.

    ../Art/DeleteUser_2x.png

    Confirm that you want to delete this iTunes Connect account.

bullet
To enable a user to be an internal tester
  1. In the “Users and Roles” pane, click iTunes Connect Users.

  2. Find the user you want to view. (For help finding a user, see To view or edit an iTunes Connect user.) The user must have an Admin, Legal, or Technical role.

  3. Click the Apple ID to display their User Details.

  4. Set the Internal Tester switch to the On position (green).

  5. Click Save.

    ../Art/EnableInternalTester_2x.png
bullet
To delete iTunes Connect users
  1. In the “Users and Roles” pane, click iTunes Connect Users.

  2. Click Edit.

  3. Select the checkbox next to each user you want to delete.

    ../Art/DeleteiTCUser_2x.png
  4. Click Delete.

  5. Confirm the deletion in the dialog box.

    ../Art/DeleteiTCUser2_2x.png
  6. Click Done.

TestFlight Beta Testers

If you want to use TestFlight beta testing to test your prerelease builds, you can view and edit your testers from the TestFlight Beta Testers pane. You can see the names and email addresses of your testers along with the devices they have registered and the latest app and build they have installed for testing. You can also search your list of testers and filter by registered device type or group.

Viewing and Editing Internal Testers

In the Internal pane, you’ll see a list of all Admin and Technical users added to your developer account. These users are eligible to be enabled as internal testers. Remember that you can enable only as many as 25 users at a time as internal testers.

To enable multiple internal testers

  1. In the “Users and Roles” pane, click TestFlight Beta Testers and Internal.

  2. Select the email addresses of the internal users you want to be internal testers.

  3. Click Save.

    ../Art/ManageTestersInternal2_2x.png

Managing External Testers

In the External pane, you can view, add, edit or delete external testers.

To add an external tester

  1. In the “Users and Roles” pane, click TestFlight Beta Testers and External.

  2. Click Add (+).

  3. Enter the email, first name, and last name of each external tester.

  4. To import a list of email addresses, click Import File.

    Choose a CSV file with the following format:

    first name, last name, email address

    For more information, download the testing import template.

  5. Optionally, under the “Add to Groups” section, select the groups (or add a group) to add the user to.

  6. Click Add.

Similarly, you can add an external tester to a specific app, as described in Adding and Inviting External Testers.

To change the name of an external tester

  1. In the “Users and Roles” pane, click TestFlight Beta Testers and External.

  2. Select the email address of the user you want to edit.

  3. Select User Details.

  4. Enter the first and last name in the text fields.

  5. Click Save.

To delete an external tester

  1. In the “Users and Roles” pane, click TestFlight Beta Testers and External.

  2. Click Edit.

  3. Select the user’s email address that you want to delete.

  4. Click Delete.

    ../Art/ManageTestersExternal2_2x.png

Organizing External Testers Into Groups

Creating groups helps you manage many external testers. To begin organizing external testers into groups, go to the “Users and Roles” page, click TestFlight Beta Testers, and click External. To apply an action to a specific group, select it from the All Groups pop-up menu before you click Edit; otherwise, the action applies to all groups.

Creating Groups

You can create groups in the External Testers area of iTunes Connect.

To create a new group of testers

  1. In the “Users and Roles” pane, click TestFlight Beta Testers and External.

  2. Click Edit.

  3. Select the email addresses that you want to add to the new group.

  4. From the Group pop-up menu, select Create New Group.

  5. In the dialog that appears, enter a name for the group and click Create.

    The Groups column displays the groups a tester belongs to. Click “…more” to see additional groups.

Editing Groups

There are several ways to edit a group after you create it.

To add or remove testers from existing groups

  1. In the “Users and Roles” pane, click TestFlight Beta Testers and External.

  2. Click Edit.

  3. Select the email addresses that you want to add or remove from an existing group.

  4. From the Group pop-up menu, select Edit Group Membership.

  5. In the dialog that appears, select or unselect the groups and click Save.

    The testers are added to the selected groups and removed from the unselected groups. If some of the testers, not all, are in a group, the checkbox displays a hyphen (–).

To change group names or delete groups

  1. In the “Users and Roles” pane, click TestFlight Beta Testers and External.

  2. From the All Groups pop-up menu (next to Edit), choose Edit Groups.

  3. In the dialog that appears, enter a name in the text field or click Delete (–) in the row of a group.

    You cannot change a tester’s email address.

  4. Click Save.

Deleting Testers in a Group

You can apply operations—such as delete—to all or select members in a group.

To remove testers from a group

  1. In the “Users and Roles” pane, click TestFlight Beta Testers and External.

  2. From the All Groups pop-up menu, choose the group you want to modify, and click Edit.

  3. Select the email addresses that you want to delete.

    To delete all the testers in a group, click the checkbox in the header.

  4. Click Delete above the table.

  5. In the dialog that appears, click Delete.

Sandbox Testers

If your app uses Apple technologies such as Game Center or In-App Purchase, you’ll want to test how your app performs with those technologies before you make the app available to users. iTunes Connect provides an interface to define sandbox tester accounts for app testing. You’ll need to configure the iTunes Connect record for your app, including configurations for the store technologies that the app uses. When you log in to a device using a sandbox tester account and run your app in development mode, the app can connect to the relevant Apple services.

Creating Sandbox Tester Accounts

Only iTunes Connect users with an Admin or Technical role can create sandbox testers.

Because you can’t edit sandbox tester accounts after you create them, you’ll want to be organized when creating them. Consider creating a spreadsheet with the relevant sandbox tester information you’ll need for all of your testing. For example, you may want to name the sandbox tester email accounts to reflect the app being tested, its version number, and the language being tested. You’ll want to correlate each language with a corresponding store territory.

../Art/mt_test_user_list_2x.png../Art/mt_test_user_list_2x.png

These are the values that need to be provided for sandbox tester accounts:

  • First name

  • Last name

  • Email address

  • Password

  • Secret question and answer

  • Date of birth

  • Store territory

Because the email address used to create a sandbox tester account can’t be associated with any existing Apple account, consider creating a dedicated email address for each sandbox tester.

If your email service provider supports email subaddressing with a plus character (+), use subaddresses of a standard address for each sandbox tester account. For example, if your base email is foo@example.com, use the foo+us@example.com, foo+uk@example.com, and foo+jp@example.com email addresses when creating sandbox tester accounts in iTunes Connect. All communications sent to the subaddresses are sent to the base address.

bullet
To create a new sandbox tester account
  1. Sign in to iTunes Connect.

  2. On the homepage, click Users and Roles.

    ../Art/UsersAndRolesIcon_2x.png
  3. On the Users and Roles page, click Sandbox Testers.

    If this option isn’t displayed, your user account doesn’t have an Admin or Technical role.

  4. Click the plus sign to add a new sandbox tester.

  5. Enter information for the sandbox tester, including store territory.

  6. Click Save.

Searching for Sandbox Tester Accounts

bullet
To search for a sandbox tester account
  1. Sign in to iTunes Connect.

  2. On the homepage, click Users and Roles.

    ../Art/UsersAndRolesIcon_2x.png
  3. On the Users and Roles page, click Sandbox Testers.

    If this option isn’t displayed, your user account doesn’t have an Admin or Technical role.

  4. In the search box, enter text you want to match part of all of the name or email address of the sandbox tester whose account you want to find. As you type, the page lists the users whose email addresses or names match the text you entered.

Updating and Deleting Sandbox Tester Accounts

After they are created, sandbox tester accounts can’t be modified. If you need to make a change, such as setting a new territory for testing, create a new sandbox tester using a new email address. Make sure to update your own records of sandbox tester information when you delete and replace a sandbox tester.

bullet
To delete sandbox testers
  1. Sign in to iTunes Connect.

  2. On the homepage, click Users and Roles.

    ../Art/UsersAndRolesIcon_2x.png
  3. On the Users and Roles page, click Sandbox Testers.

    If this option isn’t displayed, your user account doesn’t have an Admin or Technical role.

  4. Click Edit.

  5. Check the checkbox next to each user you want to delete.

  6. Click Delete.

  7. Confirm the deletion in the dialog box.

  8. Click Done.