Docs / Guides / Help members find a group

Help members find a group

In short

You will have Group Finder with its channels, working group cards and optional partner servers so groups reach more players.

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 setup needs 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 create can also set a repeat and a start time, such as start: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 create and /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 create the same choice is visibility Network 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 settings to see the listing, log and alert channels and the limits in use.
  • If something fails, see Troubleshooting.

Next

Was this page helpful?
YourBot docs Reference tables are generated from the code that is running. Ask in Discord