• Home
  • Integrations
  • SDKs
  • Guides
  • API docs
    No results for ""
    EXPAND ALL

    EDIT ON GITHUB

    Joining an account

    Read time: 3 minutes
    Last edited: Feb 27, 2023

    Overview

    This topic explains how to join LaunchDarkly as a new account member.

    LaunchDarkly is for groups and organizations

    You cannot sign up for LaunchDarkly if your email address is not associated with your organization's account. Instead, an administrator or account owner from your organization must send you an invitation email. If you want to sign up for LaunchDarkly as an individual, you can sign up for a free trial.

    Join your organization's existing account

    You can join your organization's LaunchDarkly account in one of two ways:

    • An admin can invite you to your organization's account
    • You can request access if your organization has enabled domain matching

    Joining through an Admin invite

    When an Admin invites you to your organization's LaunchDarkly account, you will receive an email from LaunchDarkly. Follow the instructions in the email to create your account and join your organization.

    Joining through domain matching

    To request access through domain matching:

    1. Navigate to the Signup page.
    2. Complete and submit the signup form. LaunchDarkly sends a verification email to the email address you provided.
    3. Click the verification link.
    4. If your organization has domain matching enabled, a list of organizations to which you can request access appears.
    5. Select an organization from the list and click "Request access."

    If your organization does not have domain matching enabled, completing the signup form in step 1 will create a new account with a 14-day trial. To learn more, read Enabling domain matching.

    How to join an organization when you already have a LaunchDarkly account

    Invitations fail when an email address is in use by another account

    If your email address is associated with a trial or other organization's account, you must de-associate it before you can receive an invitation email from your organization.

    A LaunchDarkly account can only have one email address associated with it, and one email address cannot be used for multiple LaunchDarkly accounts. If you used your preferred email address to sign up for a trial, for example, you must de-associate it from the trial account before you can join your organization's LaunchDarkly account, using one of two methods:

    • Changing your account email address
    • Deleting your other account if you are the Owner

    Changing your account email address

    To change the email address associated with an account:

    1. Log in to your existing LaunchDarkly account.
    2. Navigate to the Account settings page and click into the Profile tab.
    3. Replace your original email address in the Email address field with a new email address.
    4. Click Update my info. A re-authentication screen appears.
    5. Enter your original login email address and password. You are returned to your Profile tab.
    6. Click Update my info again. Your email address is now updated.

    You can now accept an invitation from your organization owner using the email address previously associated with the other account.

    Here is a screenshot of the Profile tab under Account settings:

    The "Profile" tab with an email address filled in.
    The "Profile" tab with an email address filled in.

    Deleting your other account

    To delete an account:

    1. Log in to your existing LaunchDarkly account.
    2. Navigate to the Account settings page and click into the Members tab.
    3. Scroll to the "Delete account" section.
    4. Click Delete account.
    5. When prompted, enter your LaunchDarkly login credentials.
    6. Click Delete account again. A confirmation dialog appears.
    7. Type yes in the dialog to confirm.

    You can now accept an invitation from your organization owner using the email address previously associated with the other account.

    Inviting other members to LaunchDarkly

    To learn how to invite other members to LaunchDarkly as an Admin, read Adding members to LaunchDarkly.

    Logging in using SSO

    If your organization has enabled single sign-on (SSO), you will log in to LaunchDarkly using your SSO provider. Your SSO login experience will differ slightly depending on whether your organization initiates the login through LaunchDarkly or through your identity provider (IdP).

    Initiating login through LaunchDarkly

    To log in through LaunchDarkly:

    1. Navigate to https://app.launchdarkly.com/login.
    2. Enter your work email address.
    3. Click Continue. You are automatically logged in through your SSO provider.

    Initiating login through your IdP

    To log in through your IdP:

    1. Navigate to your IdP, such as Google, Okta, or OneLogin.
    2. Click on the LaunchDarkly button or tile. You are automatically logged in through your IdP.

    Here is an example of the LaunchDarkly tile in Okta:

    The LaunchDarkly tile in Okta.
    The LaunchDarkly tile in Okta.

    For a list of SSO providers LaunchDarkly supports, read Supported external identity providers.

    Understanding LaunchDarkly's user entity types

    In LaunchDarkly, it is important to distinguish between account members and contexts. Here is a table explaining the difference:

    TitleDefinition
    "Account members," or "members"These are people who have been invited to join a LaunchDarkly account to create and manage feature flags. They can log into a company's LaunchDarkly account and view the flags list. They may be employees of a company that uses LaunchDarkly, people with an @your-company.com email address, or people associated with your identity provider (IdP).
    "Contexts"Contexts are entities that trigger flag evaluations. This can cause them to appear in the Contexts list in LaunchDarkly, but they cannot log into the organization's LaunchDarkly account or view or modify their own or other people's data. You can designate people, email addresses, geographical regions, and more as contexts. They can even be combinations of other contexts. They are usually not people with member access to your LaunchDarkly account, although it is possible for someone with member access to encounter one of your feature flags and appear in the Contexts list. Contexts are a flexible, highly customizable way to categorize, target, and act on groups that are affected by your feature flags. To learn more, read Understanding the foundations of contexts.