Skip to content

Latest commit

 

History

History
114 lines (72 loc) · 5.17 KB

migrating-a-user-account.md

File metadata and controls

114 lines (72 loc) · 5.17 KB
Raw

Migrating a User Account

You may already have come up with a great name for an npm user account. Now, you want to use that name for an organization. This page will teach you how to convert an npm user account to an Organization and explain what will happen to the converted user's packages.

What Happens When I Migrate?

  • All of your previous account's packages now belong to the Org.
  • All of your previous team/Org memberships and contirbutor access are assigned to your new personal user account.
  • You will no longer be able to sign in as the previous account name.
  • You will create a new npm user account.
  • Your old username will be used to create a new Organization of that name
  • Your new npm user account will be an Owner role on the newly created Organization (Learn more about Roles and Privileges)

How to Migrate

When and if you choose to migrate your npm user account to an Organization, you will need to take the following steps:

1. Login to Your npm Account

  1. Login as the npm user that you would like to convert to an Organization.

  2. Choose Create a New Organization from the avatar menu.

  3. Press the Convert button highlighted in the screen shot.

Review the issues listed to be certain you wish to go forward.

2. Create a New Personal User

Since you are converting your current user account to an Organization, you'll need to create a new one to replace it. Enter the new username you would like to use for your personal account. You will still be included in all the Orgs where you were included before, but your name will be changed to the new name you set now. We recommend you use a name similar to your prior name so that others will recognize you. For example, you can create a username like "neworgname-user".

Click Submit.

3. Choose Your Plan

Once you've chosen a name for your new personal account, you'll need to choose a plan for your new Organization.

Currently, npm offers 2 plans:

  • Free: public packages only.
  • Paid: install and publish private packages ($7/user/month).

For example, if you have 3 users, an Organization that only needs public packages will be entirely free. However, if your Organization needs to install and publish private packages, it will cost $21/month ($7/month*3 users).

You can change your plan any time through the billing panel. For more information on the features of each plan, visit our pricing page.

Once you have chosen your plan, follow screen clues to create the organization.

4. Enter Payment Information (paid Orgs only)

If you chose an Organization with access to private packages, clicking the big red "Create an Organization" button will bring up a Stripe Payments prompt. Enter the email address you'd like associated with billing (this does not have to match the Owner's email), as well as billing address and credit card information.

You can change your billing info at anytime through your Organization's billing page.

Your credit card will be immediately billed $7 for a single user, the account of the person creating the Organization.

More details and screen shots about billing are in a later chapter.

5. Add Members to your Organization

This step is described in more detail in an earlier chapter.

Once you've created your Organization, you can view your organization, so that you can add more users, or manage your teams. You can add members to your Organization at any time, so feel free to skip this step if you aren't ready to add users yet.

The user who created the Organization is:

To add users to your Organization, follow the screen cues. If you chose an Organization with private package access, every user will add an additional $7/month to your bill.

When you add a member to your Organization they are immediately added. They do not receive an email, so please let your new members know that you have added them.

All the users you add from this interface are:

If the person you would like to add to your Organization does not have an npm username, they'll need to create an npm user account. You can send them this link to sign up.