Before you start: to run the setup wizard, you need Manage Server in Discord or to be a dashboard manager.
1. Give the bot permission to create channels
Give the bot Manage Channels in the server.
Why the bot needs it
- The wizard creates a category, a text channel and a forum channel. Without the permission, it stops before changing anything.
- If you would rather use channels you already have, see step 3.
2. Run the wizard
In Discord, type /group setup. Or, on the Services page, turn on the Group Finder switch, click Open and press Set it up for me.
What the wizard creates
- A Group Finder category with #lfg-listings (everyone reads, only the bot posts) and #lfg-forum, plus starter templates and a welcome card.
- A category or channel with one of those names that already exists is used as it is.
- Setup also switches the service on.
/group setupneeds Manage Server. The dashboard button needs a dashboard manager.- See Set it up.
3. Check where groups are posted
On the Services page, open Group Finder, then Settings. Under Where groups are posted, pick Cards in a channel or A thread per group, in a forum.
What the wizard picked and the default limits
- The wizard makes every new group open its own thread in the forum.
- Defaults are 3 open groups per member, 4 hours open (48 at most) and 60 seconds between two groups.
4. Post a test group
In any channel, run /group create title:Test run. Or use New group on the dashboard.
What the reply and the card show
- After the wizard, the reply is "✅ {title} posted to #lfg-forum!".
- The card shows the leader, the group size, the time left and the buttons Join, Leave, Watch, Ready Check and Done.
- A group with role slots, such as one from
/group quick dungeon, shows a "Choose a role to join…" menu in place of Join. A group that needs approval shows Apply. /group createcan also set a repeat and a start time, such asstart:2h. See /group create.
5. Let members get alerts
Members run /group-alerts add with the game or activity they want. The bot tells them when a match is posted.
Where alerts go and the limit
- Alerts go by DM, in the alert channel or as a digest.
- If members want channel alerts, set the Channel for alert mentions under Who gets told on Settings.
- DM and channel alerts are capped at five per hour per person.
6. Optional: share groups with other servers
Open Other servers. Click Start a network and send the invite code to the other server's managers. Or paste a code under Join with a code.
Commands, switches and what leaves your server
- In Discord the same is
/group-admin network createand/group-admin network join. - Each network has Our groups show there and Their groups show here switches.
- A group leaves your server only when its leader picks Partner servers too or The public page on New group. In
/group createthe same choice isvisibilityNetwork or Public. - The public page also needs Members can put a group on the public page turned on under Other servers.
- See /group-admin network create.
7. Check that it works
Have a second member press Join on the test card. The card should show their name. Then press Done to end the group.
When the group ends and how to check the settings
- When the group ends, the card switches to closed and the group's chat turns read-only.
- Run
/group-admin settingsto see the listing, log and alert channels and the limits in use. - If something fails, see Troubleshooting.