---
title: Self-Service registration emails
description: To configure self-service registration emails, add the following code block to the selfservice-registration.json file:
component: pingidm
version: 7.5
page_id: pingidm:self-service-reference:uss-email-registration
canonical_url: https://docs.pingidentity.com/pingidm/7.5/self-service-reference/uss-email-registration.html
keywords: ["JSON", "Configuration", "Self-Service", "User Self-Service", "Email", "User Interface"]
---

# Self-Service registration emails

To configure self-service registration emails, add the following code block to the `selfservice-registration.json` file:

```json
{
    "name" : "emailValidation",
    "identityEmailField" : "mail",
    "emailServiceUrl" : "external/email",
    "emailServiceParameters" : {
        "waitForCompletion" : false
    },
    "from" : "info@example.com",
    "subject" : "Register new account",
    "mimeType" : "text/html",
    "subjectTranslations" : {
        "en" : "Register new account",
        "fr" : "Créer un nouveau compte"
    },
    "messageTranslations" : {
        "en" : "<h3>This is your registration email.</h3><h4><a href=\"%link%\">Email verification link</a></h4>",
        "fr" : "<h3>Ceci est votre mail d'inscription.</h3><h4><a href=\"%link%\">Lien de vérification email</a></h4>"
    },
    "verificationLinkToken" : "%link%",
    "verificationLink" : "https://localhost:8443/#/registration/"
},
```

The code block includes default registration email messages in English (`en`) and French (`fr`). The `verificationLink` sent with the email takes users to the IDM self-registration URL.

As noted in [Managing User Self-Registration Over REST](uss-registration-config.html#uss-registration-rest), you can make these changes over the endpoint URI: `/openidm/config/selfservice/registration`

To configure self-service registration emails using the admin UI:

1. From the navigation bar, click Configure > User Registration.

2. On the User Registration page, select the Options tab.

3. Enable Email Validation.

   |   |                                                                                                                                                                                                      |
   | - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   |   | If the Email Validation option is disabled, outbound email has not been configured. Click Configure Here, and refer to [Outbound email](../external-services-guide/email.html) for more information. |

4. In the Configure Validation Email window, enter the necessary information, and click Save.

   Self-registration email changes made using the admin UI are saved to the `selfservice-registration.json` file.
