Skip to main content
Discord Sync keeps your Discord server aligned with SquadVault players and teams. Organization admins can set this up when Discord is included in your plan. The Discord page follows the usual SquadVault layout: status (bot, guild, sync readiness), then work (connection → mapping → sync), then insights (gaps like unmapped teams).
Discord page showing bot connection and sync status

Discord — connection and sync readiness

Connect Discord

1

Invite the bot

Open Discord under Connections in the sidebar and invite the SquadVault bot to your server.
2

Connect the server

Select the Discord server you want to link to this organization.
3

Map roles

Map Discord roles to players, staff, and teams so membership stays consistent.
4

Sync

Run a sync (or a dry run first) and optionally set a log channel for sync activity.

Player vs staff roles

  • Player roles create and archive players when members gain or lose those Discord roles.
  • Staff roles do the same for org-wide staff entries (see Staff in the sidebar). Someone can be both a player and staff.
  • Staff from Discord sync is not the same as team staff (coach/analyst assigned on a team). Team staff stays a separate assignment of organization members to a team.
On a player profile, link their Discord account so role sync stays accurate. Discord user IDs must be unique within the organization.

Tryout applications

When someone receives a mapped player role in Discord, Sync creates or restores the SquadVault player. If an open tryout application in the same organization has the same Discord user ID (pending, reviewing, or shortlisted), that application is automatically marked accepted and linked to the player. Flows listening for tryout.accepted still run.

Team lists

With Pro or Elite, open Team lists under Workspace in the sidebar:
  1. Design a roster message with blocks (header, captain, players, MMR, footer).
  2. Choose embed or plain message, select teams and a Discord channel.
  3. Set Auto-update: immediately on roster changes, on a schedule (presets or advanced cron), or manual only. New schedules default to the organization timezone.
  4. Save & publish — SquadVault edits the same Discord messages when the list refreshes.
In Advanced settings you can upload an optional header image. SquadVault posts it as its own Discord message before the roster messages. Choose whether to send it as a Discord embed or as a plain message with the image URL. Remove the image and republish to delete that header message. Ranks appear when the matching integration is available for the team’s game — otherwise the list still shows player names: Connect Discord first on the Discord page. With ranks enabled, map Discord custom emojis to tiers on that same Discord page (tabs for Rocket League, Valorant, and League). Team lists can then show {{rankEmoji}} / the Rank emoji toggle. Built-in captain and player lines also link the rank text to the player’s tracker profile when a URL is available. In list settings you can also sort players by metric (highest or lowest first) instead of role order.

Custom text variables

Use a Custom text block for freeform lines. Placeholders use {{path}}. Filters like | upper work as in Flows. Variable names are the same for every game — values fill for the team’s game (e.g. {{mmr}} is MMR, RR, or LP). Inside the loop: {{ping}} (Discord mention), {{name}}, {{nationality}}, {{rankEmoji}}, {{rank}}, {{mmr}} (metric number), {{metricUnit}} (MMR / RR / LP), {{mode}} (playlist / queue), {{role}}, {{line}} (formatted rank line from Rank details settings, including emoji when mapped), {{tracker}} (Discord markdown [Tracker](url)), {{trackerUrl}} (raw URL), {{isCaptain}}. Example:

Invite members from Discord

Staff can invite someone to the SquadVault organization without leaving Discord:
  1. Right-click the user.
  2. Open Apps.
  3. Choose Invite to SquadVault.
The bot DMs them a join link. They sign in with Discord on that page — their Discord email does not need to match an invite address. If Discord blocks the DM (privacy settings), the command reply includes the link so staff can share it. This uses the same staff gate as /org and /team. Invites create a member role; change it later in SquadVault if needed.

Discord events

Turn on Sync Discord events in the Discord settings to connect your server’s scheduled events with the calendar. Sync is off by default and works in both directions:
  • Discord → SquadVault: events created in Discord appear in the calendar as organization-wide Discord event entries. Edits in Discord update them; cancelling or deleting the event in Discord removes it from the calendar.
  • SquadVault → Discord: create a calendar event with the type Discord event and SquadVault creates it on your server. Edits update the Discord event; deleting it or changing the type removes it from Discord.
Choose Location in Discord on the event:
  • Link to SquadVault (default) — an external Discord event that links back to the event in SquadVault.
  • A voice or stage channel — the event takes place in that channel. The picker only lists channels the bot can actually open.
Only shared, single events that start in the future are sent to Discord. Personal events and recurring series stay in SquadVault.

Bot permissions

Event sync needs the bot permissions Create Events and Manage Events. Stage events also need Manage Channels, Mute Members, and Move Members. Bots invited before event sync was available usually lack these. If permissions are missing, the Discord page and the dashboard show a warning with Update permissions. Re-authorize the bot once through that link — it stays on your server and keeps all settings. If Discord rejects an event, SquadVault still saves it, shows a notice, and posts the error to the log channel when one is set.

Tips

  • Use a dry run before the first live sync on a large server.
  • Keep SquadVault as the source of truth for roster changes, then sync outward.
  • Restrict Discord settings to admins so mappings are not changed by accident.
  • Create, update, publish, and refresh of team lists appear under Discord in the Audit log.
  • Automate role assignment and welcome messages with Flows.
  • Check overall connection health from Integrations.
Discord Sync requires Discord on your plan. Team lists require the team_liste feature (Pro / Elite). See Billing if the page is locked.