Skip to main content

Dapp Connections

Each time a user connects their Account to a new Dapp, you should receive a popup in Frame requesting permission for the connection, as described in the Connecting to a Dapp guide.

If you encounter issues connecting to a dapp, follow these troubleshooting steps to resolve the problem.


  1. Check the Dapp Permissions:

    • Open Frame and scroll down to the Dapps module.
    • Locate the website URL you want to connect with and check if the permission for the dapp is present.
    • If the permission is available, ensure it is enabled (indicated by a green status). If it is not available, Frame will create it upon connection.
  2. Clear Local Storage and Cookies:

    • Clear your browser's local storage and cookies, which can sometimes resolve connection issues.
  3. Close and Re-open Browser:

    • Close your browser completely and then reopen it. Sometimes restarting the browser can help establish a fresh connection.
  4. Restart Frame:

    • Restart the Frame application itself to ensure all components are running smoothly.
    • You can quit Frame either within the app menu or by right-clicking the Frame icon in your menu bar.
  5. Disable Browser Extensions:

    • Temporarily disable all extensions in your browser except for the Frame Companion.
    • If you are using Brave browser, disabling the Brave wallet can be an easy fix. The Brave Wallet currently takes priority over all other wallet connections when interacting with dapps.
    • Disabling extensions helps rule out any conflicts that might occur with the injection of providers, as most wallet browser extensions use the same window.ethereum object.
  6. Check Developer Console:

    • Open the developer console of the dapp you wish to connect to.
    • Look for any errors or warnings related to wallet connection in the console and report this to the team through a support post.
  7. Try a Different Browser:

    • If possible, try using a different browser with only the Frame Companion extension installed.
    • This helps determine if the issue is specific to the browser you were using.

Further Support

If none of the above steps resolve your issue, reach out for further support.

Visit our Discord server and raise an issue in the #support channel.

Provide the following details in your post:

  • Operating system, browser, and Frame version you are using.
  • The dapp you are trying to connect to.
  • Any errors or issues you have noticed in the dapp UI, developer console, or Frame itself.

Our team and community members will try to reproduce the issue and assist you in diagnosing and resolving the problem.