---
title: Username Collector node
description: Not supported in Advanced Identity Cloud
component: auth-node-ref
version: latest
page_id: auth-node-ref:am-only:username-collector
canonical_url: https://docs.pingidentity.com/auth-node-ref/latest/am-only/username-collector.html
keywords: ["Nodes & Trees", "Journeys", "Authentication"]
page_aliases: ["auth-node-username-collector.adoc"]
superseded_by: https://docs.pingidentity.com/auth-node-ref/latest/am-only/username-collector.html
section_ids:
  example: Example
  availability: Availability
  inputs: Inputs
  dependencies: Dependencies
  configuration: Configuration
  outputs: Outputs
  callbacks: Callbacks
  outcomes: Outcomes
  errors: Errors
  changelog: Changelog
---

# Username Collector node

Not supported in Advanced Identity Cloud

The Username Collector node prompts the user for their username.

## Example

This simple login journey demonstrates the Username Collector node.

![Simple login journey](../_images/simple-login-journey.png)

a The [Username Collector node](username-collector.html) node prompts the user to enter their username.

b The [Password Collector node](password-collector.html) node prompts the user to enter their password.

c The [Data Store Decision node](../data-store-decision.html) locates the user in the backend identity store and determines if the credentials are correct:

* If the credentials are correct, the journey follows the succcess outcome and the user is authenticated.

* If the credentials aren’t correct, the node directs the user to the [Retry Limit Decision node](../retry-limit-decision.html).

d The [Retry Limit Decision node](../retry-limit-decision.html) determines how many times the user has attempted these credentials:

* If the number of attempts doesn’t exceed the maximum, the user is redirected to the [Username Collector node](username-collector.html) to attempt their credentials again.

* If the number of attempts exceeds the maximum, the journey follows the failure outcome.

## Availability

| Product                               | Available? |
| ------------------------------------- | ---------- |
| PingOne Advanced Identity Cloud       | No         |
| PingAM (self-managed)                 | Yes        |
| Ping Identity Platform (self-managed) | No         |

## Inputs

* Version 1.0

  None. This node doesn’t read shared state data.

* Version 2.0

  If the Prepopulate Username option is enabled, the node reads the `username` from the shared state, if it’s available.

## Dependencies

This node has no dependencies.

## Configuration

| Property             | Usage                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Availability      |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- |
| Prepopulate Username | Whether the node should prepopulate the `username` if it’s available in the shared state.Default: Not enabled                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | [v2.0](#v2)       |
| Autocomplete Values  | (Optional) Enter one or more autocomplete values. These values provide autofill suggestions to the user when they’re prompted for their username. Make sure you only use standard autocomplete values that are defined in the [HTML specification](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/autocomplete) to ensure browsers can recognize them and provide relevant suggestions.For example, if you enter `username`, users will see username suggestions based on the autofill data that’s been saved in their browser.

If you want users to see relevant passkeys as autofill suggestions when prompted for their username, make sure you:

Include the username and webauthn autocomplete values in this order.

Configure the WebAuthn Authentication node for passkey autofill. Learn more in Configure WebAuthn conditional UI. | All node versions |

## Outputs

The node writes the captured `username` to shared state.

## Callbacks

The node sends a [NameCallback](https://docs.pingidentity.com/pingam/8.1/am-authentication/callbacks-interactive.html#NameCallback) to prompt the user for their username.

## Outcomes

Single outcome path.

Evaluation continues after capturing the username.

## Errors

This node doesn’t log any error or warning messages of its own.

## Changelog

| Version                                                         | Changes                                                    |
| --------------------------------------------------------------- | ---------------------------------------------------------- |
| []()2.0 AM only *(tooltip: Currently available only in AM 8.1)* | Addition of the Prepopulate Username configuration option. |