> 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="https://129318620-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDDJNhJVFiHXUkYj2IXXu%2Fuploads%2FpIpiIiUVTHQSURoluxPU%2FScreenshot%202025-11-04%20105000.png?alt=media&amp;token=2eca6f3d-0186-4430-a67c-2206d11a6559" 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="https://129318620-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDDJNhJVFiHXUkYj2IXXu%2Fuploads%2Fo37IuGuIBljLo94Qjcml%2FScreenshot%202025-11-04%20105417.png?alt=media&amp;token=cd485f3a-c8e8-4ebd-bed5-ae8891fa387d" 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="https://129318620-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDDJNhJVFiHXUkYj2IXXu%2Fuploads%2F1tO8T7y4TDUooZ2Va8kq%2FScreenshot%202025-11-04%20105645.png?alt=media&amp;token=614c20e0-aab1-4698-a30c-e0dc304811e0" 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.
