---
title: User self-registration form
description: During user self-registration, IDM displays user attributes on the user registration form, as defined in the selfservice-registration.json file. You can modify the displayed properties in the registrationProperties code block:
component: pingidm
version: 7.5
page_id: pingidm:self-service-reference:uss-registration-form
canonical_url: https://docs.pingidentity.com/pingidm/7.5/self-service-reference/uss-registration-form.html
keywords: ["JSON", "Configuration", "Self-Service", "User Self-Service"]
---

# User self-registration form

During user self-registration, IDM displays user attributes on the user registration form, as defined in the `selfservice-registration.json` file. You can modify the displayed properties in the `registrationProperties` code block:

```json
"registrationProperties" : [
    "userName",
    "givenName",
    "sn",
    "mail"
],
```

To add user attributes to the user self-registration form using the admin UI:

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

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

3. Below the list of attributes, click the drop-down list, select an attribute, and click Add.

   |   |                                                                                 |
   | - | ------------------------------------------------------------------------------- |
   |   | This action also adds the attribute to the `registrationProperties` code block. |

The user self-registration form displays attributes in the listed order.

You can also set up user self-registration via configuration files, as described in the following table:

**User Self-Registration Configuration Files**

| File Name                       | Description                                                                                                                                    |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `external.email.json`           | To enable email verification, you must configure an [outgoing email server](../external-services-guide/email.html).                            |
| `managed.json`                  | You can customize user self-registration based on entries in this file. To change the labels seen by end users, change the associated `title`. |
| `policy.json`                   | For more information, refer to [Custom policies for self-registration and password reset](uss-policy-json.html).                               |
| `selfservice.kba.json`          | refer to [Security questions](selfservice-questions.html).                                                                                     |
| `selfservice-registration.json` | refer to [User self-registration](uss-registration-config.html).                                                                               |
| `ui-configuration.json`         | refer to [User self-registration](uss-registration-config.html).                                                                               |