# Change password widget

## Overview

You use the *Change password* widget to enable users to change their password.

This widget provides additional functionality to the *Login form* widget.

## Place the widget on the page

You can place a *Change password* widget only inside a *Section* widget.\
To do this, perform the following:

1. Inside a column from the *Section* widget, click *Add widget here…*
2. Select the *Login & Users* tab.
3. Click the *CHANGE PASSWORD* widget.\
   The widget is placed inside the selected column of the *Section* widget.

> success **RESULT**: The widget displays the *Current password*, the *New password*, the *Repeat new password* filed, and the *Save* button.\
> You can change these labels in the advanced widget settings.

## Widget settings

To open the widget settings, perform the following:

1. In the page editor, hover over the widget.
2. Click the toggle menu in the widget label.
3. Click ![DotNetCore8](https://www.progress.com/documentation/sitefinity-cms/assets/e29dbb581da97d8aa6aad6943253dd7a/dotnetcore8.jpg "DotNetCore8") (*Edit*).\
   The *Change password* page opens.

### Choose what to do after a user changes the password

In the *Change password* setup section you can do the following:

Under \*After change users will...\*choose what to do after the users change their password:

* If you want to display a message after a password is changed, select *View message* and in the *Message text* box, enter the text of the message.
* If you want to redirect the user to a particular page, select *Redirect to page*.\
  Click ![Add](https://www.progress.com/documentation/sitefinity-cms/assets/ed18f87316e449f58adc9531a6244938/add.png "Add") (*Select page*) and select a page from your website.\
  For example, you can select the login page.

In *Display setting* section, you can do the following:

### Change the template

To change the template that the *Change password* widget uses, select the new template in the *Change password template* dropdown box.

You must first have created a custom template.\
For more information, see [ASP.NET Core pages and templates](https://www.progress.com/documentation/sitefinity-cms/create-an-asp.net-core-page).

### Configure the widget margins

In *Margins*, you can choose the margins between the text and the column where it is placed.\
Choose from the predefined values of none, small, medium, or large.

Save your changes

## Advanced widget settings

To open the advanced settings, in the upper-right corner of the *Change password* widget page, click ![DotNetCore11](https://www.progress.com/documentation/sitefinity-cms/assets/0b5bf6d61861bf099d7f849dde3e94ea/settings-dotnetcore.jpg "DotNetCore11") (*Advanced settings*)

* In *Label*, you can enter a specific name for this widget.  This name will be displayed in:
  * The page editor as a label for the widget when you hover over it.
  * In the treeview with the page structure in the right pane of the page editor.
* • In *CSS class*, you can enter individual CSS class for the *Change password* widget.

Save your changes.

### Configure the labels of the widget

You can change the following labels:

 <table>
<tbody>
<tr>
<td>

<strong>Label</strong>

</td>
<td>

<strong>Description</strong>

</td>
<td>

<strong>Default value</strong>

</td>
</tr>
<tr>
<td>

<em>Change password header</em>

</td>
<td>

The label that is displayed on the frontend page

</td>
<td>

Change password

</td>
</tr>
<tr>
<td>

<em>Current password field label</em>

</td>
<td>

The label of the field where the user enters the current password

</td>
<td>

Current password

</td>
</tr>
<tr>
<td>

<em>New password field label</em>

</td>
<td>

The label of the field where the user enters the new password

</td>
<td>

New password

</td>
</tr>
<tr>
<td>

<em>Repeat password field label</em>

</td>
<td>

The label of the field where the user repeats the new password

</td>
<td>

Repeat new password

</td>
</tr>
<tr>
<td>

<em>Submit button</em>

</td>
<td>

The label of the button that confirms the password change

</td>
<td>

Save<br>

</td>
</tr>
<tr>
<td>

<em>Login error message</em>

</td>
<td>

The message that is displayed when the user is not logged in

</td>
<td>

You need to be logged in to change your password.

</td>
</tr>
<tr>
<td>

<em>Required fields error message</em>

</td>
<td>

The message that is displayed when a required field is not filled out

</td>
<td>

All fields are required.

</td>
</tr>
<tr>
<td>

<em>Password mismatch error message</em>

</td>
<td>

The message that is displayed when the new password is and its confirmation do not match

</td>
<td>

New password and repeat password don't match.

</td>
</tr>
<tr>
<td>

<em>External provider message
</em>

</td>
<td>

The message that is displayed when the user is logged with external identity provider and cannot change their password using the <em>Change password</em> widget.

</td>
<td>

Your profile does not store any passwords, because you are registered with {0}

</td>
</tr>
</tbody>
</table>