Multiple Guilds System Documentation
The Multiple Guilds system lets you keep one primary guild and add secondary guilds under the same Discord server, so member management works across your full guild structure.
Prerequisites: You must complete
/setup start first. The setup guild becomes your primary guild.
Table of Contents
- ⚠ Multiple Guilds vs Alliance — Important Difference
- System Overview
- Requirements
- Dashboard Access
- Guild List
- Add Secondary Guild
- Remove Secondary Guild
- Discord Command: /multi-guild
- Troubleshooting
⚠ Multiple Guilds vs Alliance — Read This First
This is the most common mistake. The bot has two completely separate systems
for adding guilds. Make sure you use the right one.
There are two different systems that deal with guilds, and they serve entirely different purposes:
| System | Commands | Who are these guilds? | What happens when you add them? |
|---|---|---|---|
| Multiple Guilds Dashboard → Guilds |
/multi-guild add/multi-guild remove |
Extra guilds your leadership owns and controls (e.g., a farm guild, a secondary roster, a sister guild) | Their members receive your main member role and are treated as full members of your server |
| Alliance Dashboard → Alliance |
/alliance add-guild/alliance setup |
Partner guilds from other organizations you cooperate with but don’t control | Their players can request the alliance role through a verification flow — they are treated as allied visitors, not full members |
Never add a secondary guild of your own organization via the Alliance system.
If you do, their players will be treated as outside allies and will go through a manual
verification process instead of being recognized as full members. They will receive the
alliance role instead of your member role, which will break your permission structure.
Never add a partner/allied guild via the Multiple Guilds system.
If you do, their players will be treated as full guild members and receive your member role
automatically, with no verification step. This removes the boundary between your guild
and your allies and can cause serious permission conflicts.
Rule of thumb: If you own or control the guild — use
Multiple Guilds (
/multi-guild). If it’s a partner from
another organization — use Alliance (/alliance).
System Overview
This system was built for guild structures that operate with more than one Albion guild under a single Discord server.
- Primary guild: the guild configured during setup. It is protected and cannot be removed.
- Secondary guilds: additional guilds that can be added or removed when needed.
- Unified management: all guilds are grouped under the same Discord server context.
Requirements
- Bot setup completed with
/setup start. - A valid management role configured in setup.
- The guild must exist in Albion Online API for the selected server.
Dashboard Access
- Open the web dashboard.
- Select your Discord server.
- Open Guilds in the dashboard sidebar.
- Use the page to search and manage secondary guilds.
Guild List
The guild list shows all guilds configured for the selected Discord server.
- Primary badge: locked entry (cannot be removed).
- Secondary badge: removable entry.
- Each row includes guild name, Albion guild ID, and server.
Important: The primary guild always stays in the list because it is the setup base for this server.
Add Secondary Guild
- Click Add Secondary Guild.
- Type at least 2 characters of the guild name.
- Select the correct guild from the search results.
- Click Add Guild.
The system blocks duplicates and also blocks adding the same guild that is already the primary guild.
Remove Secondary Guild
- Find the secondary guild in the list.
- Click Remove.
- Confirm removal.
Only secondary guilds can be removed. Primary guild removal is not allowed.
Discord Command: /multi-guild
Managers can use slash commands to manage guilds without opening the dashboard.
Add
/multi-guild add guild-name: YourGuildName
- Searches Albion API by guild name.
- Adds the guild as secondary when valid.
- Blocks primary guild and duplicate entries.
Remove
/multi-guild remove guild-id: AlbionGuildId
- Removes a secondary guild by Albion guild ID.
- Prevents removing the primary guild.
View
/multi-guild view
- Returns an embed with Primary Guild and Secondary Guilds.
- Shows name, guild ID, and server for each entry.
- Useful for quick verification directly in Discord.
Troubleshooting
- Server not configured: run
/setup startfirst. - No permission: your account needs the configured management role.
- Guild not found: verify guild name spelling and server.
- Duplicate guild: the guild is already configured as secondary.
- Primary removal blocked: expected behavior by design.