---
title: Display Username node
description: "Look up and display a user's username based on a different identifying attribute, such as an email address, to support username recovery flows."
component: auth-node-ref
version: 8.1
page_id: auth-node-ref::display-username
canonical_url: https://docs.pingidentity.com/auth-node-ref/latest/display-username.html
llms_txt: https://docs.pingidentity.com/auth-node-ref/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: 2026-08-18T00:00:00Z
keywords: ["Nodes & Trees", "Journeys", "Authentication"]
page_aliases: ["auth-node-display-username.adoc"]
section_ids:
  availability: Availability
  configuration: Configuration
  callbacks: Callbacks
---

# Display Username node

Fetches a username based on a different identifying attribute, such as an email address, then displays it.

To email the username to the user instead, use the [Identify Existing User node](identify-existing-user.html) combined with a [Email Suspend node](email-suspend.html) or [Email Template node](email-template.html).

## Availability

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

1 This functionality requires that you configure AM as part of a [Ping Identity Platform deployment](https://docs.pingidentity.com/platform/8.1/sample-setup/).

## Configuration

| Property           | Usage                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| User Name          | The attribute used to identify the username in the managed identity object.                                                                                                                                                                                                                                                                                                                                                 |
| Identity Attribute | The attribute used to identify the managed object in the underlying identity service (PingIDM).When this node serves to recover a username, the identity attribute should be some other attribute that is unique to a user object, such as the email address.The node raises an exception when more than one value exists for this attribute. Make sure the value of whatever attribute you select is unique for each user. |

## Callbacks

The node sends a [TextOutputCallback](https://docs.pingidentity.com/pingam/8.1/am-authentication/callbacks-read-only.html#textoutputcallback), which displays the user's username as informational text.