NFTs
Discord

Simple SpaceWatch Setup for NFT Collection

Get started with SpaceWatch by inviting it to your server, adding an NFT Collection and setting up a role to be assigned.

11/26/20253 minute read
Simple SpaceWatch Setup for NFT Collection

1. Invite SpaceWatch to Your Server

  1. Sign in to the dashboard and open Dashboard → Servers.
  2. Scroll to Servers Without SpaceWatch.
  3. Click Invite Bot. This opens Discord’s OAuth screen at
    https://discord.com/oauth2/authorize?client_id=1099835126738866228&permissions=268435456&scope=bot+applications.commands.
  4. Complete the Discord prompts (pick the server, grant permissions). When the bot joins, the card moves to Configured Servers with a Manage Server button.

Tip: if the bot is already present, click Manage Server to jump straight into configuration.


2. Add an NFT Collection

Once inside the Server Management view, you land on the NFT Collections tab.

Option A – Import from XRP Café vanity URL

  1. Click Add Collection.
  2. In the dialog’s Import with XRP Café section, paste the vanity slug (the piece after xrpcafe.com/collection/).
  3. Press Find. The app resolves issuer/taxon automatically.
  4. Review the pre-filled fields (you can still edit them) and click Add Collection.

Option B – Enter details manually

  1. In the same dialog, fill in:
    • Collection Name – e.g., RudeBoys.
    • Issuer Address – the XRPL issuer account.
    • Taxon – optional; leave blank to include every NFT from that issuer.
  2. Submit with Add Collection.

While saving, watch the inline status indicator (top-right “Saving…”). Once complete, the table shows live on-chain counts plus metadata coverage, so you can verify the import succeeded.


3. Create a Role Rule

Navigate to the Roles tab in the same server page.

  1. Click Add Role.
  2. Pick the Discord role to grant (dropdown lists every non-managed role).
  3. Choose a Category:
    • NFT for collection-based gating (with options for amount, trait type, or trait value).
    • Token for issued currencies or MPTs.
  4. Set your condition:
    • Simple roles use a single rule (e.g., “hold 1 NFT from Collection A”).
    • Multi-condition (Premium) allows complex AND/OR logic across multiple collections/tokens.
  5. Save the rule. It appears in the table with edit/delete controls and a blacklist manager for edge cases.

Remember: premium limits unlock more rules (20), multi-condition logic, token gating, and sales feeds. Use the Settings → Premium Features card for a quick comparison if you need to upgrade.


4. Publish the Verification Flow in Discord

With collections and roles ready, switch to your Discord server:

  1. Ensure SpaceWatch has a text channel where members can verify.
  2. Run the slash command /setup and pick the channel to post the message to.
  3. Test it yourself: click Verify and link your wallet or use the web dashboard, then wait and see if your role is granted.

5. Check Discord Role Hierarchy

Discord only allows a bot to assign roles that sit below the bot’s highest role.

  1. Open Server Settings → Roles in Discord.
  2. Drag the SpaceWatch role above every role you configured in the dashboard (e.g., “Verified Holder”).
  3. Save the order.
    • If the hierarchy is wrong, SpaceWatch cannot grant the role.

Final Checklist

  • Bot invited and visible in Configured Servers.
  • At least one NFT collection added (via XRP Café or manual issuer/taxon).
  • Role rule created and saved (simple or multi-condition).
  • /setup run in a live Discord channel to post the verification message.
  • SpaceWatch role positioned higher than every auto-assigned role.

Need help applying this guide?

Jump into the SpaceWatch dashboard or chat with the team in Discord.