# Changing a Matrix Account password

<!---
Actions needed:
- [ ] 

# Changing a Matrix Account password
--->

<!---<p class="callout info">Remember to check our <a href="https://ems-docs.element.io/books/kieranml-test-book/page/have-you-tried-httpselementiohelp">Looking for help?</a> page for answers to Frequently Asked Questions and our User Guide!</p>--->

<p class="callout warning"><b>Disclaimer:</b> This guide refers to using the Element Matrix clients, <a href="https://app.element.io/" target="_blank" rel="noopener noreferrer">Element Web</a> or <a href="https://element.io/download" target="_blank" rel="noopener noreferrer">Element Desktop</a> apps</p>

### Changing your Matrix Account password

<p class="callout warning">If you don't know your password, you'll need to recover your account, see our <a href="https://ems-docs.element.io/books/element-support/page/recovering-a-matrix-account">Recovering a Matrix Account</a> page for instructions.</p>

1. Go to Element `All settings`
	
	![profile_menu](https://vector-im.github.io/emsdocs-images/images/Screen%20Shot%202020-09-17%20at%205.24.15%20PM.png)
	
	You might want to export your `E2E room keys`. Just to be on the safe side in case something goes wrong. See also [Export and Import E2E Room Keys](export-and-import-e2e-room-keys)

2. Enter your current password and your new password
	
	![set_new_account_password](https://vector-im.github.io/emsdocs-images/images/Screen%20Shot%202020-09-17%20at%205.26.13%20PM.png)

3. Click `OK`
	
	![password_change_success](https://vector-im.github.io/emsdocs-images/images/Screen%20Shot%202020-09-17%20at%205.31.01%20PM.png)

4. You now need to sign in again on all your other devices

### Changing a Matrix Account password on your Homeserver

If you're an EMS customer, you can create your users via the <a href="https://ems.element.io/user/hosting#/admin" target="_blank" rel="noopener noreferrer">Server Admin</a> tab of the <a href="https://ems.element.io/user/hosting" target="_blank" rel="noopener noreferrer">EMS Control Panel</a>.
<!---Check out the [Server Admin]() section of the [EMS Control Panel]() doc for more guidance.--->

Alternatively you can make use of the <a href="https://matrix-org.github.io/synapse/latest/usage/administration/admin_api/" target="_blank" rel="noopener noreferrer">Synapse Admin API</a> to change a Matrix Account password on a homeserver you hold an Admin account on. To do so, you will need to use <a href="https://matrix-org.github.io/synapse/latest/admin_api/user_admin_api.html#create-or-modify-account" target="_blank" rel="noopener noreferrer">Create or Modify Account</a> from the <a href="https://matrix-org.github.io/synapse/latest/admin_api/user_admin_api.html#user-admin-api" target="_blank" rel="noopener noreferrer">User Admin API</a>.
<!---For more information on using the <a href="https://matrix-org.github.io/synapse/latest/usage/administration/admin_api/" target="_blank" rel="noopener noreferrer">Synapse Admin API</a> check our [Getting Started using the Admin API]() documentation.--->

```
https://HOMESERVER_URL/_synapse/admin/v2/users/FULL_USERNAME
```

```json
{
    "password": "new_password"
}
```