We are using Auth0 in my company, in prod for many years now, and we’ve just started seeing an issue in the test environments, not in prod yet luckily.
It’s related to the ULP, screen reset-password-request, text descriptionEmail. We’ve been using this key but recently noticed there is another one called emailDescription, and it’s causing a broken UI. We are uncertain if there’s been a recent Auth0 update to our tenants around these fields. I’ve used AI assistant of Auth0 page to clarify the differences between these 2 fields and it said they might be new (image attached).
Can you please tell me what’s the difference between these 2 fields emailDescription and descriptionEmail for screen reset-password-request and if one of them has been recently created? I couldn’t find in the recent logs mentions of this specific screen, Auth0 Changelog. Thank you.
I understand that you are looking to understand that difference between the emailDescription and descriptionEmail fields for the reset-password-request screen.
The descriptionEmail field is the older key used for legacy database Connections before Auth0 released Flexible Identifiers, whereas emailDescription is the newer key used in conjunction with newer database connections that support Flexible Identifiers, please see Customize Universal Login Text Elements - Auth0 Docs
Recommended approach
It is highly likely that your test environment either uses a newly created database connection or was recently updated to support Flexible Identifiers. Because of this change, the Universal Login Page (ULP) on the reset-password-request screen is now looking for the new emailDescription key. As your current configuration only includes the legacy descriptionEmail key, the ULP is missing the expected value, resulting in the broken UI you are seeing. This behaviour has been outlined in our Support Article on the Difference between descriptionEmail and emailDescription Keys for Universal Login Custom Texts.
