--- title: Email customizations - general (legacy) description: Several PingID services send out emails to users. component: pingid page_id: pingid:pingid_service_management:pid_email_customization_general canonical_url: http://docs.pingidentity.com/pingid/pingid_service_management/pid_email_customization_general.html revdate: March 15, 2026 section_ids: email-templates: Email templates --- # Email customizations - general (legacy) Several PingID services send out emails to users. | | | | - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | PingID email customizations are deprecated and won't be supported after April 2026. If you're migrating to PingOne, use PingOne notification templates instead. Learn more in [Notification templates](http://docs.pingidentity.com/pingone/user_experience/p1_notifications.html).This feature doesn't support the Domain-based Message Authentication, Reporting, and Conformance (DMARC) protocol. If you're migrating to PingOne, you can use PingOne notification templates, which do support DMARC. Learn more in [Configuring a custom SMTP email notification server](http://docs.pingidentity.com/pingone/settings/p1_configure_custom_smtp_server.html) in the PingOne documentation. | The following table shows the email sources. | Email address source | Reference | | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | RADIUS | Refer to **Multiple Attribute Mapping Rules** in the General Parameters table of [PingID RADIUS PCV parameters reference guide](../pingid_integrations/pid_radius_pcv_parameters.html) | | PingID API | Refer to the Add User section of [PingID API - AddUser](https://apidocs.pingidentity.com/pingid-api/guide/pingid-api/pid_c_PingIDapiUserManagement/#AddUser) in the PingID API documentation. | | AD FS | Refer to **Email Attribute** in step 4 of [Configuring advanced settings](../pingid_integrations/pid_configuring_advanced_settings.html) | | Azure AD | Refer to step 4e of [Configuring PingID MFA for Microsoft Azure AD Conditional Access](../pingid_integrations/pid_cfg_azure_conditional_access.html) | | PingID for PingFederate | Refer to **Email Attribute** in step 5 of [Configuring a PingID adapter instance](../pingid_integrations/configuring_a_pid_adapter_instance.html) | | PingOne SSO stand alone | [Connecting to an identity repository](http://docs.pingidentity.com/pingoneforenterprise/pingone_for_enterprise/p14e_connecting_idp.html) | Four email customizations are available: 1. Customize the email "From" address to change the default address of `noreply@pingidentity.com` to `noreply@yourdomain.com`. 2. Customize the email "Replyto" address to change the default address of `noreply@pingidentity.com` to `noreply@yourdomain.com`. 3. Customize the email "Subject" line. | | | | - | --------------------------------------------------------------------------------------------------------------------------------- | | | To change items 1 to 3 above, sign on to the [Ping Identity Support Portal](https://support.pingidentity.com/s/) and open a case. | 4. Customize the email message body. PingID supplies templates to customize the body of notification mails. To download the templates, see [PingID email templates](https://download.pingidentity.com/public/PingID/PingID-Email-Templates.zip). Download the `.zip` file and extract it. The included `readme.txt` file contains a directory list of templates. ## Email templates The downloaded `.zip` file contains HTML templates for all PingID notification emails. You can view the files as-is in a web browser. The HTML templates use both mandatory and optional variables (replacement macros). The Templates variables and usage table lists each variable. NOTE: If you include images in any of the templates, they must be URL references to publicly available assets. Ping Identity doesn't host the images used in templates. After editing your template, contact [PingID Customer Support](https://www.pingidentity.com/en/support/customer-support.html) to upload the template. About the table: 1. Variables are marked as follows: * M - mandatory * O - optional * Blank - irrelevant. 2. Variables all take the form `$[.parmname]`{variable\_name}\`\`\`\`. Mandatory variables must appear in your edited template. 3. The table lists visible variables. Each template also includes undisplayed variables, which are listed in the footnotes. 4. The variable `${service-provider}` is optional for all files except `Download and Pair PinglD.html`. For `New Email Authentication Request.html`, it's also currently visible. **Templates variables and usage** | Template File | Variables | | | | | Template usage | | | | ------------------------------------------- | ----------- | -------------------- | ------------------- | ------------------ | --------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | | | ${org-name} | ${one-time-passcode} | ${service-provider} | ${activation-code} | ${current-year} | User Paired New Device of Specific Type | Pairing | Remarks | | `webauthn_platform_android.html`(1) | M | | O | | O | Web: Android biometric | | | | `webauthn_platform_iphone.html` (1) | M | | O | | O | Web: iPhone FaceID | | | | `webauthn_platform_macintosh.html` (1) | M | | O | | O | Web: Mac Touch ID | | | | `webauthn_platform_windows.html` (1) | M | | O | | O | Web: Windows Hello | | | | `webauthn_platform.html` (1) | M | | O | | O | Web: Other biometric | | | | `webauthn.html`(1) | M | | O | | O | Web: Security key | | | | `android.html` (2) | M | | O | | O | Android device app | | | | `authenticatorAppEmailTemplate.html`(1) | M | | O | | O | Authenticator app | | | | `desktop.html` (3) | M | | O | | O | Desktop app | | | | `email.html` (3) | M | | O | | O | Authentication by email response | | | | `iphone.html` (2) | M | | O | | O | iPhone device app | | | | `oathTokenEmailTemplate.html` (1) | M | | O | | O | Authentication by OATH hardware token | | | | `sms.html`(3) | M | | O | | O | Authentication by SMS response | | | | `voice.html` (3) | M | | O | | O | Authentication by voice response | | | | `yubikey.html` (1) | M | | O | | O | Authentication using a YubiKey | | | | `Download and Pair PinglD.html`(4) | | | | M | | | When user clicks **Get Download Link** during registration | QR image required | | `Email Authentication Pairing.html`(5) | | M | O | | O | | Pairing code delivery is used when user clicks the **Receive passcodes via email** button during registration | One-time passcode sent by email | | `New Email Authentication Request.html` (5) | | M | O (Visible) | | O | | One-time passcode delivery during authentication | One-time passcode sent by the service provider | Notes to the table: 1. These files have the following additional optional undisplayed variables * `${cloudfront-url}`: Image * `${fraud-link}`: **Report fraud** button 2. These files have the following additional optional undisplayed variables * `${cloudfront-url}`: Image * `${device-name}` * `${device-details}` * `${fraud-link}`: **Report fraud** button 3. These files have the following additional optional undisplayed variables * `${cloudfront-url}`: Image * `${device-details}` * `${fraud-link}`: **Report fraud** button 4. The `Download and Pair PinglD.html` file has the following additional optional undisplayed variables: * `${download-link-for-iphone-ipad}`: iOS download link * `${download-link-for-android}`: Android download link * `${no-scan-pairing-link}`: Link to **Finish Pairing PingID** button image * `${qrcode-image}`: Link to QR code image 5. These files have the following additional optional undisplayed variable: * `${download-link-for-android}`: Android download link