--- title: Managing populations description: PingOne allows you to organize users into populations to simplify user and policy management. component: pingone page_id: pingone:directory:p1_manage_populations canonical_url: https://docs.pingidentity.com/pingone/directory/p1_manage_populations.html revdate: February 13, 2025 section_ids: p1-view-pop-tab: Viewing populations steps: Steps result: Result overview: Overview configuration: Configuration password-policy: Password Policy users: Users groups: Groups p1-add-pop-tab: Adding a population steps-2: Steps p1-edit-pop-tab: Editing a population steps-3: Steps result-2: Result: result-3: Result: p1-delete-pop-tab: Deleting a population before-you-begin: Before you begin steps-4: Steps --- # Managing populations PingOne allows you to organize users into populations to simplify user and policy management. Click the appropriate tab for instructions on: * Viewing your existing populations and their details * Adding a new population * Making changes to a population * Deleting an unused population - Viewing populations - Adding a population - Editing a population - Deleting a population ## Viewing populations Use the **Populations** page to view populations in PingOne. ### Steps 1. In the PingOne admin console, go to **Directory > Populations** and browse or search for the population that you want to view. 2. Click the population entry to open the details panel. ### Result The population details panel shows information about the population on the following tabs: #### Overview The **Overview** tab shows general information about the population. | Field | Description | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Population Name** | A unique label for the population. | | **Description** | A brief description of the population, if one was entered. | | **Population ID** | A unique identifier for the population. You can click the Copy icon to copy the population ID to the clipboard. | | **Identity Provider** | The default identity provider (IdP) *(tooltip: \
\

A service that manages identity information and provides authentication services to relying clients or SPs within a federated or distributed network.\

\
)* for the population if one was selected. When nothing else is selected, PingOne is used as the default IdP during the runtime. Click the title to go to the specific identity provider. If your IdP isn't enabled, the word **Disabled** displays next to the title. Manage your IdPs from **Integrations > External IdPs**. | #### Configuration The **Configuration** tab displays information about settings that apply only to DaVinci. These settings are not used in sign-on policies. | Field | Description | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Alternative Identifiers** | A domain, ID, or custom value used to identify the population. | | **Language** | The preferred language for this population. Learn more in [Languages](../user_experience/p1_languages.html). If a population doesn't have a selected language, the default language for the environment is used. | | **Theme** | The default branding theme for this population. Learn more in [Branding and themes](../user_experience/p1_branding_themes.html) and [Adding a theme](../user_experience/p1_add_theme.html). If a population doesn't have a selected theme, the active theme for the environment is used. | #### Password Policy The **Password Policy** tab shows detailed information about the password policy in use for the population. | Field | Description | | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | **Password Policy** | The [password policy](../authentication/p1_passwordpolicies.html) assigned to the population. Click the link to go to the **Password Policies** page. | | **Description** | A brief description of the password policy. | | **Password Policy ID** | The ID of the password policy assigned to the population. Click the password ID to copy it to the clipboard. | | **Password Requirements** | The requirements for the password. For example, the password must be 12 characters long, or it requires special characters. | | **Password Policy Rules** | The password rules for the policy. For example, a rule that requires the user change their password every 6 months. | | **Account Lockout Rules** | The lockout rules for the account. For example, after five incorrect password entries, the user is locked out for a period of time. | #### Users The **Users** tab shows the list of [users](p1_aboutusers.html) currently in the population. #### Groups The **Groups** tab shows the list of [groups](p1_groups.html) currently in the population. ![Screen capture of the populations default details page.](_images/configurationpopulationtab.png) ## Adding a population Use the **Populations** page to add a population in PingOne. ### Steps 1. In the PingOne admin console, go to **Directory > Populations**. 2. Click the **[icon: plus, set=fa]**icon to add a population. 3. Enter the following: | Field | Description | | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Population Name** | A unique label for the population. | | **Description** (optional) | A brief description of the population. | | **Default Population** | Select the checkbox to specify the current population as the default population. Users created without a specified population are added to the default population. If you are changing the default population, PingOne shows a confirmation message. Click Confirm. | 4. Click **Save**. ## Editing a population Use the **Populations** page to edit existing populations. ### Steps 1. In the PingOne admin console, go to **Directory > Populations** and browse or search for the population you want to edit. 2. Click the population entry to open the details panel. 3. On the **Overview** tab, click the **Pencil** icon, edit or enter the following, then click **Save**: | Field | Description | | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Population Name** | A unique label for the population. | | **Description** (optional) | A brief description of the population. | | **Identity Provider** (optional) | The default IdP *(tooltip: \
\

A service that manages identity information and provides authentication services to relying clients or SPs within a federated or distributed network.\

\
)* for the population. If you are changing the default IdP, PingOne shows a confirmation message. Validate the IdP configuration to avoid lockout and click Confirm. This setting is used at runtime for users in the population who do not have Authoritative Identity Provider configured in their user profile, and only for as long as they remain in the population. When a user doesn't have an IdP configured in their user profile, the default IdP from the population PingOne is used. If Authoritative Identity Provider is set on the user profile, that setting is used to authenticate the user. The user profile setting is not updated or changed by the setting on the population. You must have the Identity Data Admin role or a custom role with equivalent permissions to configure this setting. Learn more in Authoritative identity providers. | | **Default population** | Select the checkbox to specify the current population as the default population. Users created without a specified population are added to the default population. If you change the default population, PingOne shows a confirmation message. Click Confirm. | 4. (Optional) On the **Configuration** tab, click the **Pencil** icon, edit or enter the following, then click **Save**. | | | | - | ------------------------------------------------------------------------- | | | These settings apply only to DaVinci and aren't used in sign-on policies. | | Field | Description | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Alternative Identifiers** | A domain, ID, or custom value used to identify the population. | | **Language** | The preferred language for this population. Learn more in [Languages](../user_experience/p1_languages.html). If you don't select a language, the default language for the environment is used. | | **Theme** | The default branding theme for this population. Learn more in [Branding and themes](../user_experience/p1_branding_themes.html) and [Adding a theme](../user_experience/p1_add_theme.html). If you don't select a theme, the active theme for the environment is used. | 5. (Optional) On the **Password Policy** tab, the **Standard** default policy shows. Click the **Pencil** icon, select a different password policy that is configured in your environment, then click **Save**. Learn more in [Password policies](../authentication/p1_passwordpolicies.html). 6. (Optional) On the **Users** tab, browse or search for a user. Click the **More Options** (⋮) icon and click **Manage User Profile**. #### Result: The **Users** page opens, and the user details panel shows. Learn more in [Changing a user's population](p1_changeuserpopulation.html). | | | | - | --------------------------------------------------------------------------------------------------------- | | | Users are added to the default population when a population isn't specified during the new user creation. | 7. (Optional) On the **Groups** tab, browse or search for a group. Click the **More Options** (⋮) icon and click **Manage Group**. #### Result: The **Groups** page opens, and the group details panel shows. Learn more in [Managing groups](p1_managing_groups.html). 8. Click **Save**. ## Deleting a population Use the **Populations** page to remove populations that you no longer need. ### Before you begin * To delete a population, you must have the Environment Admin role or a custom role with equivalent permissions. * You must remove all users from a population before you can delete it. ### Steps 1. In the PingOne admin console, go to **Directory > Populations** and browse or search for the population you want to delete. 2. On the right side of the population entry, click the **More options** (⋮) icon and then click **Delete**. 3. On the confirmation message, click **Delete**.