# 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: 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.
