Create and Manage Partner Development Orgs

Learning Objectives

After completing this unit, you’ll be able to:

  • Describe the tasks you perform from the Environment Hub.
  • Describe how to set up single sign-on to member orgs in the Environment Hub.

What Is the Environment Hub?

It’s time to start creating orgs. The Environment Hub app is your one-stop shop for org creation and org management.

Using the Environment Hub app, you can connect existing orgs to the hub. You can create standard and partner edition orgs for development, testing, and packaging your app. You can set up single sign-on from your hub org to its connected orgs to provide easy access to development and testing orgs.

If you want to try out the steps in this unit, you need an org with the Environment Hub app.

Permissions Required for Using the Environment Hub

If you have the System Administrator profile, you have the permissions necessary for using all the Environment Hub features. We are going to assume that you have those superpowers and that you can’t wait to create an org.

But if you want other users to access the hub or you don’t have those permissions, you can go set them up now. Learn more about the permissions for hub access in the Configure the Environment Hub section of the ISVforce Guide. You or your Salesforce admin can set up a new profile, modify an existing profile, or create a permission set with the correct permissions.

Enable My Domain in Your Development Management Org

Environment Hub requires My Domain. Orgs created in Winter '21 or later have My Domain enabled by default. If you’re a partner and set up your development management org before the Winter '21 release, you may need to enable My Domain in that org. See the User Authentication module for instructions on how to set up My Domain.

Feel the Power: Create Your First Org

Now let’s create a development org in which you can create a simple app.

  1. From the App menu, select Environment Hub.
  2. From the ITEMS list, select Environment Hub.
  3. Click Create Org.
  4. For Purpose, select Development.
  5. In Org Name, enter Trailhead Development Org. Screen for creating an org
  6. Fill in the remaining required fields. Since this is a new org, you must enter a new username, as usernames can't be reused across Salesforce orgs.
  7. Read the Master Subscription Agreement and choose whether to accept.
  8. Click Create.

When your org is ready, you receive an email confirmation, and the org appears in your list of hub members. When the email arrives, click Verify Account to activate the org.

A Brief Aside…

Before you continue, make sure that you have the AppExchange partner version of the Environment Hub.

  1. Click Create Org.
  2. For Purpose, select Test/Demo.
  3. Verify that your Edition picklist looks like this one. Edition menu with Partner versions of editions
  4. Click Cancel.

If you don’t see the highlighted edition options, file a case in the Salesforce Partner Community to get the AppExchange partner Environment Hub. The Partner editions last for one year. Non-partner editions have a shorter lifespan.

Set Up Single Sign-on (SSO)

When your org is ready, it’s listed as a connected org in your Environment Hub.

List of hub members with action menu highlight

Notice the drop-down menu on the right. It has a Login option. If you haven’t set up SSO, Login simply takes you to a login page. Let’s activate SSO to make full use of the Environment Hub.

  1. Select the org name from the list of environments.
  2. Click Enable SSO.
  3. Confirm that you do want to enable SSO by clicking Enable SSO on this new screen.
  4. Go to the Single Sign-On User Mappings related list, and select New SSO User Mapping.
  5. For Username on Member Org, look up a user in the Environment Hub. For Environment Hub User, enter the username you used to set up Trailhead Development Org. New SSO User Mapping screen
  6. Click Save.
  7. Select Login.

You are now logged in to the related org. Useful, isn’t it? When you logged in to the member org, you didn’t provide a password. Connecting without a password is possible because you created the org using the Environment Hub.

Check out the Single Sign-on in the Environment Hub section of the ISVforce Guide for other SSO methods that you can use for connecting orgs.

Let’s Do It Again

It never hurts to practice, right? And really, we need a test org in which to load the package containing your app in the next unit. So, here goes.

  1. From the App menu, select Environment Hub.
  2. From the ITEMS list, select Environment Hub.
  3. Click Create Org.
  4. For Purpose, select Test/Demo.
  5. In Org Name, enter Trailhead Test.
  6. Fill in the remaining required fields. Remember, this must be a new username, as it must be unique across all Salesforce orgs.
  7. Read the Master Subscription Agreement, and then choose whether to accept.
  8. Click Create.

Don’t forget. Look for your email confirmation, and wait for your org to appear in your list of hub members. After you have the confirmation and have verified your account, go ahead and set up SSO to make your life easier.

Keep Organized

You’re going to create many orgs over the lifetime of your business. Using custom list views with the Environment Hub app makes your life easier by helping you to find orgs quickly.

When you create a custom list view, you set filters to determine which orgs you see and to specify the columns to display.

Connect Other Orgs to the Hub

Maybe you’re an enthusiast who started creating your app in a Developer Edition org before you signed up as an AppExchange Partner. Or maybe you have some other orgs hanging around that you’d like to access from your Environment Hub. No problem. Here’s how.

  1. Log in to the Environment Hub, and then select Connect Org.
  2. Enter the admin username for the org that you want to connect and, optionally, a short description. A description makes it easier to find the org later, especially if your hub has many members.
  3. By default, single sign-on (SSO) is enabled for the org you connected. To disable SSO, deselect Auto-enable SSO for this org.
  4. Select Connect Org again.
  5. In the pop-up window, enter the org’s admin username and password. If you don’t see the pop-up, temporarily disable your browser’s ad blocking software and try again.
  6. Select Log In, and then select Allow.

Moving Orgs from One Hub to Another

At some point, your company could grow to the point that you want to have another org with an Environment Hub. It’s easy to disconnect an org from an Environment Hub using the Remove command.

And it’s easy to connect it to the same Environment Hub again. However, to connect it to a new Environment Hub, you file a case to Partner Support to break the association to the previous Environment Hub.


You now know how to:

  • Create an org using the Environment Hub.
  • Connect an existing org to the Environment Hub.
  • Set up SSO.
  • Use custom list views to help you stay organized.

Bravo. Take the quiz, then on to the next unit where you get to use those orgs.

Keep learning for
Sign up for an account to continue.
What’s in it for you?
  • Get personalized recommendations for your career goals
  • Practice your skills with hands-on challenges and quizzes
  • Track and share your progress with employers
  • Connect to mentorship and career opportunities