---
title: HTML Form Adapter events
description: The HTML Form Adapter offers self-service account management tools for password management, account recovery, username recovery, and email ownership verification.
component: pingfederate
version: 13.1
page_id: pingfederate:administrators_reference_guide:pf_html_form_adapt_events
canonical_url: https://docs.pingidentity.com/pingfederate/13.1/administrators_reference_guide/pf_html_form_adapt_events.html
llms_txt: https://docs.pingidentity.com/pingfederate/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: July 5, 2022
section_ids:
  related-links: Related links
---

# HTML Form Adapter events

The HTML Form Adapter offers self-service account management tools for password management, account recovery, username recovery, and email ownership verification.

When you configure an HTML Form Adapter instance to deliver its messages based on an SMTP Notification Publisher instance configuration, administrators can optionally customize and localize the following template files with branding controls to provide a consistent brand experience to end users across multiple user populations.

| Email subject and template file name                                       | Event                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Action                                                                                                                                                |
| -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Password Change Notificationmessage-template-end-user-password-change.html | A user's password has been changed successfully through an instance of the HTML Form Adapter.                                                                                                                                                                                                                                                                                                                                                                                                                                      | Users should contact their IT administrators if they have not made any attempts to change their password.                                             |
| Password Resetmessage-template-forgot-password-link.html                   | A user has initiated a self-service password reset request.Applicable when the password reset type for the invoked HTML Form Adapter instance is set to **Email One-Time Link**.                                                                                                                                                                                                                                                                                                                                                   | Users should contact their IT administrators if they have not made any attempts to reset their password.                                              |
| Password Resetmessage-template-forgot-password-code.html                   | A user has initiated a self-service password reset request.Applicable when the password reset type for the invoked HTML Form Adapter instance is set to **Email One-Time Password** or **Text Message**.                                                                                                                                                                                                                                                                                                                           | Users should contact their IT administrators if they have not made any attempts to reset their password.                                              |
| Password Reset Completedmessage-template-forgot-password-complete.html     | A user's password has been reset successfully through an instance of the HTML Form Adapter.Applicable when the password reset type for the invoked HTML Form Adapter instance is set to any method except **None**.                                                                                                                                                                                                                                                                                                                | Users should contact their IT administrators if they have not made any attempts to reset their password.                                              |
| Account Unlockedmessage-template-account-unlock-complete.html              | A user account has been unlocked successfully through an instance of the HTML Form Adapter.Applicable when the **Account Unlock** option is enabled for the invoked HTML Form Adapter instance.                                                                                                                                                                                                                                                                                                                                    | Users should contact their IT administrators if they have not made any attempts to unlock their account.                                              |
| Account Unlock Email Template                                              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                                                                                                                       |
| Password Reset Failedmessage-template-forgot-password-failed.html          | An attempt to reset the end-user's password has failed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Users should contact their IT administrators if they have not made any attempts to reset their password, or to seek help in resetting their password. |
| Email Verificationmessage-template-email-ownership-verification.html       | A user has provided an email address on the registration page, updated an existing email address with a new one on the profile management page, requested a resend of the verification email on the profile management page, or accessed the email ownership verification endpoint.Applicable only if the invoked HTML Form Adapter instance is associated with a local identity profile that has been configured to offer users the opportunity to verify the ownership of the email address associated with the accounts.        | Users should contact their IT administrators if they have not made any attempts to update the email address associated with their accounts.           |
| Username Recoverymessage-template-username-recovery.html                   | A user has initiated a self-service username recovery request and provided an email address through an instance of the HTML Form Adapter. If PingFederate can locate the user record using such email address and other requirements are met, PingFederate uses this template to generate an email message containing the recovered username and sends it to the user at the email address provided by the user.Applicable only if the invoked HTML Form Adapter instance is configured to support self-service username recovery. | Users should contact their IT administrators if they have not made any attempts to recover the username associated with their accounts.               |

## Related links

* [Configuring an HTML Form Adapter instance](pf_config_html_form_adapt_instance.html)

* [HTML Form Adapter advanced fields](pf_html_form_adapter_advanced_fields.html)

* [Localizing messages for end users](pf_local_message_end_users.html)
