How to Update Application Username Using an Expression Language
Jan 12, 2026
Lifecycle Management
Okta Classic Engine
Okta Identity Engine
Overview
This article describes how to update application usernames using Okta Expression Language (OEL).
Applies To
- Okta Expression Language (OEL)
Solution
To update the username format on a specific application, navigate to the application in question: Sign On > Application Username Format > Edit > Custom > Enter the appropriate expression.
Some popular expression examples are below:
- For FirstName.LastName, use the following expression: user.firstName + "." + user.lastName
- For FirstName + LastName, use the following expression: user.firstName + user.lastName
- For First Initial + LastName, use the following expression: substring(user.firstName, 0, 1) + user.lastName
