Medusa Docs

Member Guide

Member troubleshooting

Resolve common sign-in, wallet-linking and Discord-role problems before escalating them.

Dashboard sign-in problem

Medusa refreshes Discord OAuth access automatically when the current session contains valid refresh information. A legacy session created before refresh support, or a Discord session that can no longer be refreshed, may require one fresh sign-in.

  1. 1Open medusauth.xyz and sign in with Discord again.
  2. 2Make sure the Discord authorization finishes in the same browser session.
  3. 3Reload the dashboard after authentication.
  4. 4If the session remains stale, sign out and sign in once more before reporting the issue.

Discord role is missing

  1. 1Confirm the required asset is in a wallet linked to your Medusa profile on the correct chain.
  2. 2Do not move the asset while troubleshooting.
  3. 3Give the administrator the wallet address and network you expect to qualify.
  4. 4Ask the administrator to inspect the active rule and Verification Logs. For Solana rules, Check wallet can provide an additional read-only diagnosis.

Information to include when asking for support

  • Discord server name.
  • Your Discord user ID when requested by the administrator.
  • The public wallet address involved and the expected network.
  • The expected collection, token, EVM contract or role.
  • A screenshot of the Medusa error without seed phrases, private keys or other secrets.
Still need help? Follow the troubleshooting checklist before escalating the issue.Open troubleshooting →