> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vaultcord.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Common Errors

> Find solutions to our most common errors here.

<AccordionGroup>
  <Accordion title="How to fix Invalid OAuth2 redirect URL." icon="dollar-sign"> Navigate to the [Discord Developer Page](https://discord.com/developers/applications?new_application=false) and select your bot. Next click on the **OAuth2 tab** and click **Add Redirect** then paste **[https://vaultcord.win/auth](https://vaultcord.win/auth)** and click **Save Changes.** </Accordion>
  <Accordion title="How to fix Unknown Guild in the VaultCord dashboard." icon="dollar-sign"> Go to the [VaultCord dashboard](https://dash.vaultcord.com) and click on the **Servers tab.** Then select your server, and head to the Discord tab inside of the dashboard. Then invite the bot to your Discord server, and select the Discord server as the server you added the bot to. Then press **Save Changes**. <img src="https://cdn.vaultcord.com/docs/discord-server-settings.png" /></Accordion>
  <Accordion title="How to fix Error Detected. Contact support with this ID." icon="shield-check"> Please [contact our support](https://vaultcord.com/discord) and send **a screenshot of the error** and ID. We'll help you fix this as soon as possible. </Accordion>
  <Accordion title="Why do I get a VPN error when I verify with iPhone?" icon="shield-check"> Please disable [iCloud relay](https://support.apple.com/en-in/guide/iphone/iph499d287c2/ios) to fix this error. </Accordion>
  <Accordion title="Bot is offline or not responding in my server" icon="shield-check"> - Open the [VaultCord dashboard](https://dash.vaultcord.com) → Servers tab → select your server → Discord tab, and make sure the bot is **invited** to the correct server. - Check that the bot’s role has the required permissions (Send Messages, Read Message History, Embed Links; plus Manage Roles/Kick/Ban if you use those features). - Ensure the bot’s role is **above** any roles it needs to manage in the role list. - If you recently changed permissions, re-invite the bot from the dashboard and try again. </Accordion>
  <Accordion title="Slash commands are not showing up" icon="shield-check"> - Re-invite the bot from the dashboard ensuring the invite includes the **applications.commands** and **bot** scopes. If that doesn't help, go to the **Bots** page and click Update Slash Commands. </Accordion>
  <Accordion title="I can’t see my server in the dashboard" icon="shield-check"> - Verify you’re logged into the dashboard with the **same Discord account** that has access to the server. - You must have the **Manage Server** permission on the server to manage it in VaultCord. - Click your avatar in the dashboard and **Log out**, then log back in to refresh Discord permissions. - If the server still doesn’t appear, invite the bot to the server from the dashboard and refresh. </Accordion>
  <Accordion title="Can’t invite the bot to my server" icon="shield-check"> - You need the **Manage Server** permission in the target server to invite the bot. - Try inviting from the dashboard’s Discord tab for your server. - If the invite page shows no servers, make sure you’re logged into the correct Discord account and that the server allows bot invites. </Accordion>
  <Accordion title="Bot can’t assign roles or manage members" icon="shield-check"> - Move the bot’s highest role **above** the roles it needs to assign/manage in Server Settings → Roles. - Ensure the bot has the needed permissions (e.g., Manage Roles, Kick Members, Ban Members). - Check per‑channel permission overrides for any blocks on the bot. </Accordion>

  <Accordion title="How to fix Couldn't find verify link authUrl error" icon="link-slash">
    This error occurs when the core `authUrl` variable is accidentally deleted or replaced with a hardcoded link (e.g., `vaultcord.win/...`) in your verification message settings.

    <Frame>
      <img src="https://r2.vaultcord.com/transfer-discord-app-not-matching.png" />
    </Frame>

    <Warning>
      VaultCord **requires** the exact `authUrl` variable to generate unique, secure verification links for each individual member. If you manually replace this variable, the bot cannot link the user to the verification system, which results in this error.
    </Warning>

    ### Step-by-Step Solution

    <Steps>
      <Step title="Navigate to Server Settings">
        First, go to the [VaultCord Dashboard](https://dash.vaultcord.com) and click on the **Servers** tab. Select your server from the list, navigate to the **Settings** menu, and open the **Message** tab.
      </Step>

      <Step title="Access the JSON Editor">
        Scroll down to the **Components** section, which is where your interactive buttons are configured. Click the **Options** dropdown button and select **JSON Editor**.

        <Frame>
          <img src="https://r2.vaultcord.com/docs-faq-discohook-options-btn.png" />
        </Frame>
      </Step>

      <Step title="Locate and replace the broken button code">
        In the JSON editor, find the code block that controls your verification button. You will likely see an incorrect URL value. Delete that specific button block and replace it entirely with this corrected code:

        ```json theme={null}
        {
          "type": 2,
          "style": 5,
          "label": "Verify now",
          "url": "{authUrl}",
          "disabled": false
        }
        ```

        <Note>
          Ensure you only replace the broken button block and leave other components (like your "Why?" button) intact.
        </Note>
      </Step>

      <Step title="Save and Test">
        Once you have pasted the correct code, click **Save Changes**. Go back to your Discord server and trigger a new verification message to ensure the button now works perfectly.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Why are my Ads not showing after users verify?" icon="rectangle-ad">
    If you have turned on the Ads program but your members do not see ads after clicking the "Verify" button, it is usually because of **duplicated verification links**.

    If you recently backed up or cloned your Discord server, you might have **two servers using the same verification link** (for example, `vaultcord.win/your-server`) in your VaultCord dashboard.

    <Info>
      **Why it breaks:** If two servers use the same custom vanity URL, VaultCord cannot tell them apart. To avoid problems like endless loops, the ad redirect does not work and the ad is skipped.
    </Info>

    ### How to Fix It

    <Steps>
      <Step title="Check Your Servers">
        Log in to your [VaultCord Dashboard](https://dash.vaultcord.com/servers) and check your list of active servers. See if more than one server is using the same `vaultcord.win` URL.
      </Step>

      <Step title="Navigate to Settings">
        Pick one of the servers with the duplicate link, usually the clone or backup, and click the **Settings** button for that server.
      </Step>

      <Step title="Change the Verification Link">
        Find the **Vanity Link** or **Custom URL** section in the settings. Change the end of the URL to something unique. For example, you can change `vaultcord.win/main` to `vaultcord.win/main-backup`.
      </Step>

      <Step title="Save and Test">
        Save your changes. Then, ask a friend or use another account to test the new verification process. The ad should now show up as expected!
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

<Card title="Contact Live Chat Support" icon="headset" href="https://vaultcord.com/discord">
  Our support team is available through Live Chat on our website. Please share your Order ID or the email you used for the transaction so we can help you faster.
</Card>