---
title: Username Collector node
description: The Username Collector node prompts the user for their username.
component: auth-node-ref
version: 8
page_id: auth-node-ref::am-only/username-collector
canonical_url: https://docs.pingidentity.com/auth-node-ref/8/am-only/username-collector.html
keywords: ["Nodes & Trees", "Journeys", "Authentication"]
page_aliases: ["auth-node-username-collector.adoc"]
section_ids:
  example: Example
  availability: Availability
  inputs: Inputs
  dependencies: Dependencies
  configuration: Configuration
  outputs: Outputs
  callbacks: Callbacks
  outcomes: Outcomes
  errors: Errors
---

# Username Collector node

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

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

## Dependencies

This node has no dependencies.

## Configuration

This node has no configurable properties.

## Outputs

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

## Callbacks

The node uses a [NameCallback](https://docs.pingidentity.com/pingam/8/authentication-guide/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.