OneKey Support Center

OneKey browser extension tutorial

  • Updated

The new version of OneKey browser extension (version 1.9.0 and above) supports direct connection to OneKey hardware address. Select Get started as HW only on the OneKey extension interface.


First, go to the official OneKey browser extension download address, select the extension version corresponding to the browser to download and install.


If the OneKey extension is already installed and the wallet address is unlocked

1. How to connect the wallet address with the DApp of the project platform?

Take Uniswap as an example. Select MetaMask, OneKey extension will automatically jump to the connection.


2.I downloaded the OneKey extension and MetaMask extension at the same time, how do I switch? 

Note: To avoid conflicts, please do not enable the MetaMask extension and OneKey extension at the same time, just select one.

Chrome: Click More in the upper right corner, find Settings, select Extensions, and then turn off, open or remove the extension.


Firefox:In the upper right corner of the browser, select Add-ons and Themes, and find the OneKey extension to close or open it.


The OneKey browser extension connection and usage tutorial are as follows:

Use hardware wallet address only.

If you only want to use the address of the hardware device, after the browser extension is installed, select Get started as HW only in the following interface. Then follow the prompt steps to continue.


Note: When the Passphrase needs to be entered, please do not enter it, just click Confirm.Because it is easy for novices to confuse Passphrase and login passwords, so that the address cannot be retrieved.

Please click on the tutorial to understand what Passphrase is and how to use it correctly:Passphrase function overview and usage guide.

Next, select the address and enter the account.


Use both hot wallet address and hardware address.

After downloading and installing the OneKey browser extension, select Get Started on the following page.


If you already have a hot wallet, you can choose to import an existing software wallet on the left. If not, then select Create HD Wallet.

Note: The software wallet is a hot wallet, and it has a parallel relationship with the hardware wallet (the address group generated by the hardware device). Please do not import the address of the hardware wallet into the hot wallet. For detailed differences, please click the tutorial to understand : The difference between software wallet and hardware wallet.


The mnemonic phrase generated at this time is the mnemonic phrase of the software wallet address (hot wallet). Please record it and keep it.10.png11.png

After clicking All Done, the creation is successful, and the account and address of the software wallet are displayed.

If you want to use the address of the hardware wallet, connect the OneKey hardware device to the computer, and then select Connect Hardware Wallet.

Tips:If there is no Bridge in your computer, or you have downloaded it but blocked by the computer, you will be prompted to download Bridge. Bridge is used to strengthen the connection stability. You can operate according to the prompts, or manually open the official website:  and select the bridge corresponding to the system to download and install.(If the Bridge download page cannot be loaded, please remember to disconnect the hardware device from the computer first, and then try to refresh the page.)


How to create multiple addresses?

Select Connect Hardware Wallet . After the connection is successful, the address group will appear. Select the address and click Unlock to connect to the second hardware wallet address.14.png

How to switch networks?

Click on the upper left corner, drop down to select switch main network.


How to view the full address and modify the address name:

Find the account column in the upper right corner and operate as shown in the figure below.


Tutorial extension:

● Regarding how to add tokens to the browser extension, you can check : How to add tokens to OneKey extension.

● If the hardware signature cannot be completed on the DApp, you may need to open the blind sign: Blind Sign Description and Usage Tutorial

How to add onekey bridge as a trust on a Mac computer

● We advocate one mine for one address. For specific reasons, you can check : Why DeFi needs OneKey

● If there is a problem connecting your hardware wallet with the OneKey browser extension, please go to our help center to troubleshoot : OneKey hardware wallet and browser connection problems and solutions.



Please perform a small transfer test before transferring large amounts of funds.

Please back up the mnemonic phrase of the hardware wallet. mnemonic phrase is the only way to restore assets.

Novices should not turn on Passphrase. If you forget Passphrase, you cannot use mnemonic words to restore your assets.

If funds permit, please purchase two OneKeys, one for use and one for importing mnemonic words for backup.



The above is the tutorial about using the OneKey browser extension.

Was this article helpful?

2 out of 3 found this helpful

Have more questions? Submit a request



Please sign in to leave a comment.