> For the complete documentation index, see [llms.txt](https://docs.polkagate.xyz/polkagate/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.polkagate.xyz/polkagate/polkagate-extension-user-guide/master-password/migration-to-master-password.md).

# Migration to Master Password

Users who restored accounts from a JSON file containing multiple accounts with different passwords will be guided through a simple migration process to the new Master Password system.

**Note:** Users with versions **earlier than 1.14.0** who update their PolkaGate extension to **1.14.0 or higher** will see the migration process as well.  This ensures that all existing accounts are updated to use the new Master Password system.

**Step 1: Set Your Master Password**

Choose a Master Password that will be used for both unlocking the extension and signing transactions for all your accounts.

<figure><img src="/files/GgeunJG2JzsLkr5X5g8H" alt=""><figcaption><p>Set Master Password (full-screen)</p></figcaption></figure>

**Step 2: Update Account Passwords**

PolkaGate will check all your accounts and detect any that have a password different from your Master Password.\
For each such account, you’ll be asked to **enter its current password** so it can be updated automatically to match your Master Password.

<figure><img src="/files/flbpm1XYV1U6QdSZkGNe" alt=""><figcaption><p>Migrate accounts password (full-screen)</p></figcaption></figure>

**Step 3: Confirmation**

Once all account passwords are updated, you’ll see a confirmation screen. From now on, you only need to enter your Master Password once to unlock the extension and approve transactions.

<figure><img src="/files/eOKOlT95hrlWjBkXO7sI" alt=""><figcaption><p>Password Migration Completed (full-screen)</p></figcaption></figure>

✅ This process ensures a smooth migration while keeping your accounts secure, and lets you enjoy the simplicity of the Master Password system immediately.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.polkagate.xyz/polkagate/polkagate-extension-user-guide/master-password/migration-to-master-password.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.