Skip to main content

​
Installing SubWallet Extension

SubWallet Extension is available for all major browsers. Follow the steps below to install SubWallet and start managing your Web3 assets.

​
Browser Requirements

Before installing SubWallet, ensure your browser meets the minimum requirements:

Chrome & Chromium

Version 111 or higher

Firefox

Latest stable version

Brave

Latest stable version

Edge

Latest stable version
SubWallet uses Manifest V3, which requires Chrome version 111 or higher. Other Chromium-based browsers (Brave, Edge, Opera) also support the extension.

​
Installation Methods

1

Visit the Chrome Web Store

Navigate to the SubWallet Extension page on the Chrome Web Store
The extension is published as “SubWallet - Polkadot Wallet” in the store.
2

Click 'Add to Chrome'

Click the Add to Chrome button to begin the installationA popup will appear asking you to confirm the permissions required by SubWallet.
3

Confirm Permissions

Review and confirm the following permissions:
  • Storage - Store wallet data and settings locally
  • Tabs - Detect when you’re on a dApp that needs wallet connection
  • Notifications - Send transaction confirmations and alerts
  • Side Panel - Display the extended wallet interface
Click Add Extension to proceed.
4

Pin the Extension

After installation, click the puzzle icon in your browser toolbar and pin SubWallet for easy access
Pinning the extension makes it visible in your browser toolbar, allowing quick access to your wallet.

​
Method 2: Install on Firefox

1

Visit Firefox Add-ons

Navigate to the SubWallet Extension page on Firefox Add-ons
2

Add to Firefox

Click Add to Firefox and confirm the installation when prompted
3

Grant Permissions

Approve the required permissions for SubWallet to function properly

​
Method 3: Manual Installation (Development)

For developers or users who want to install from source:
Manual installation is intended for developers and advanced users. For regular use, install from the Chrome Web Store or Firefox Add-ons.
1

Clone the Repository

git clone https://github.com/Koniverse/Subwallet-V2.git
cd Subwallet-V2
2

Install Dependencies

yarn install
SubWallet uses Yarn 3.0.1 as its package manager. Make sure you have the correct version installed.
3

Build the Extension

For Chrome/Chromium browsers:
yarn build
For Firefox:
yarn build:zip:dst-ff
The built extension will be in packages/extension-koni/build (Chrome) or packages/extension-koni/build-firefox (Firefox).
4

Load Unpacked Extension

For Chrome:
  1. Navigate to chrome://extensions
  2. Enable “Developer mode” (toggle in top-right)
  3. Click “Load unpacked”
  4. Select the packages/extension-koni/build directory
For Firefox:
  1. Navigate to about:debugging#/runtime/this-firefox
  2. Click “Load Temporary Add-on”
  3. Select the manifest.json file from packages/extension-koni/build-firefox

​
Development Installation

If you’re developing or testing SubWallet:
1

Start Development Server

For Chrome (with source maps):
yarn watch-dev
For Firefox:
yarn dev:firefox
2

Load in Browser

Follow the same steps as manual installation to load the unpacked extension
The watch command will automatically rebuild when you make changes to the source code.

​
Post-Installation

After installing SubWallet Extension:

​
1. Verify Installation

Click the SubWallet icon in your browser toolbar. You should see the welcome screen.

​
2. Check Extension Details

Verify you have the correct extension installed:

​
3. Review Permissions

SubWallet requires the following permissions:
PermissionPurpose
StorageSecurely store wallet data, settings, and encrypted keys in browser local storage
TabsDetect active dApps and inject wallet provider when needed
NotificationsAlert you about transaction confirmations and important events
Side PanelProvide extended portfolio and transaction views
All wallet data is encrypted and stored locally in your browser. SubWallet never sends your private keys or seed phrases to external servers.

​
4. Next Steps

Now that SubWallet is installed, proceed to the Quick Start guide:

Quick Start Guide

Set up your wallet and create your first account

​
Troubleshooting

​
Extension Not Appearing

If the extension icon doesn’t appear after installation:
  1. Check if it’s hidden - click the puzzle icon in your browser toolbar
  2. Pin SubWallet to make it always visible
  3. Refresh your browser or restart it

​
Installation Failed

1

Check Browser Version

Ensure you’re running Chrome 111+ or the latest version of your browser
2

Clear Browser Cache

Clear your browser cache and cookies, then try installing again
3

Disable Conflicting Extensions

Temporarily disable other wallet extensions that might conflict
4

Try Manual Installation

If automatic installation fails, try the manual installation method

​
Build Errors (Development)

If you encounter errors during the build process: 
# Clean previous builds
yarn clean

# Reinstall dependencies
rm -rf node_modules
yarn install

# Rebuild
yarn build
Run yarn lint before building to catch any code issues early.

​
Updating SubWallet

​
Automatic Updates

Extensions installed from the Chrome Web Store or Firefox Add-ons will update automatically.

​
Manual Updates

For manually installed extensions:
  1. Pull the latest changes: git pull origin master
  2. Install new dependencies: yarn install
  3. Rebuild: yarn build
  4. Reload the extension in your browser

​
Security Best Practices

After installing SubWallet:
  • Never install SubWallet from unofficial sources
  • Verify the publisher is “SubWallet” before installing
  • Keep your browser updated to the latest version
  • Only download from official stores or the GitHub repository
  • Be cautious of phishing websites claiming to be SubWallet

​
Uninstalling SubWallet

If you need to uninstall SubWallet:
1

Export Your Accounts

CRITICAL: Export your seed phrases and private keys before uninstalling
Uninstalling will delete all locally stored data. Without your backup, you’ll lose access to your accounts permanently.
2

Remove Extension

Chrome: Right-click the extension icon → Remove from ChromeFirefox: Navigate to Add-ons → SubWallet → Remove

​
Need Help?

If you encounter issues during installation:

Continue to Quick Start

Learn how to set up your first wallet

Build docs developers (and LLMs) love

Get started for freeTalk to us