Docs / Core Services / Group Finder / Troubleshooting
Built in 39 commands 15 settings

Group Finder: Troubleshooting

In short

Fixes for setup that stops, groups that do not post, members who cannot post or join and alerts that never arrive.

The setup wizard stops and nothing is created

Why: The wizard checks that the bot has Manage Channels before it changes anything. Without it, the wizard stops with "The bot is missing the Manage Channels permission. Grant it (or Administrator) and run setup again. Nothing was changed."

Fix: Give the bot Manage Channels (or Administrator) in Discord. Then run /group setup again, or click Set it up for me on the Home page of Group Finder.

The dashboard shows a banner that the bot is missing permissions

Why: The bot's role lacks a permission Group Finder needs. The banner lists what is missing.

Fix: Click Fix with one click in the banner and approve the invite in Discord.

What the check looks at
  • It covers the basic message permissions, Read Message History, Manage Channels, Manage Roles, Manage Threads and Create Public Threads.
  • It looks at the whole server, not at single channels.
  • A role with Administrator never gets the banner.

/group setup says "Already Configured"

Why: Setup counts as done once both the Channel and the Forum of Where groups are posted are saved. From then on, /group setup only shows them and does not run again.

Fix: Run /group-admin settings to see the channels, and change them on the dashboard under Services, Group Finder, Settings. To make anything that is missing, use Setup and health on Settings.

/group setup says I need Manage Server

Why: Only a member with Manage Server can run the wizard. The reply is "You need Manage Server permission to run setup."

Fix: Ask a server owner or a member with Manage Server to run it.

Members get "The Group Finder service is switched off in this server."

Why: Group Finder is switched off for the server. Every Group Finder command answers this while it is off.

Fix: If you have Manage Server, press the Switch on button under that reply. You can also open the dashboard, choose the server, open Services and switch Group Finder on.

A member cannot post a group

Why: /group create refuses for one of these reasons, each with its own reply:

When The bot says
The account is too new "Your account is too new to post here. This server requires accounts at least {days} day(s) old."
The member is suspended from posting A reply that says they are suspended
They already have the most open groups allowed "You already have {count} active listing(s) (max {max})."
They posted another group too fast "You can create another listing in {secs}s."
The title or description holds a blocked word "Your listing contains a blocked keyword and cannot be posted."

Fix: Change the limits under Services, Group Finder, Settings. To lift a suspension, run /group-admin unsuspend. The defaults are 3 open groups per member and 60 seconds between two groups.

The reply says the group is live but I cannot find the card

Why: The card goes only where Where groups are posted says. With A thread per group, in a forum, the card is the first post of a thread in the forum. Nothing is posted in the channel.

Fix: Open Services, Group Finder, Settings, check Where groups are posted and pick a Channel or a Forum. For forum posts, make sure the bot has Manage Threads and Create Public Threads.

Forum refusals, and posting with no channel
  • If the forum is not a forum channel any more or Discord refuses the thread, no thread is made.
  • With no channel set at all, the first /group create adopts the channel it was typed in.
  • A group made with New group on the dashboard is not posted in Discord when no channel is set.

A group set to The public page only reaches partner servers

Why: A leader's choice of The public page works only when the server allows it. Otherwise the group is shared with partner servers only, and New group says "The public page is off on this server. A manager can allow it under Other servers."

Fix: Open Other servers and turn on Members can put a group on the public page.

Members do not see groups from other servers

Why: A group stays in its own server unless the leader picks Partner servers too or The public page. For partner servers, the network also needs the right switches.

Fix: On Other servers, check that Their groups show here is on for your server. Our groups show there must be on for the posting server. Run /group-admin network list to see the networks.

A member cannot join a group

Why: The reply tells which case it is:

When The bot says
They are already in the group or its waitlist "You're already in this group or waitlist."
The leader removed them "You were removed from this group by the leader and can't rejoin."
The group needs the leader's approval "{title} requires leader approval. Use /group apply instead."
The group is full and has no waitlist "This group is full with no waitlist."
The group is full and its waitlist is on "Group {title} is full. You've been added to the waitlist!"

Fix: Use /group apply or the Apply button for a group that needs approval. A member the leader removed cannot rejoin that group.

A member cannot use a command that others can

Why: Command access rules decide who runs each command, and a blocked member is told they cannot use the command here. The Balanced or Locked down preset limits /group noshow, /group approve, /group deny and /group report to moderator roles, because they are in the moderation category.

Fix: Open Services, Group Finder, Commands and give those commands a rule of their own. By default, /group-admin commands are hidden from members without Manage Server. See command access.

Alerts never arrive

Why: One of these is the cause:

  • A member picked delivery by Channel and the server has no Channel for alert mentions. Those alerts are not sent, and /group-alerts add warns "This server has no alert channel configured."
  • The alert falls inside the member's quiet hours. Those alerts are dropped, not delayed.
  • The member already got 5 alerts in the hour. DM and channel alerts are capped at 5 per hour.
  • The group is the member's own. A member's own groups never trigger their own alerts.

Fix: Pick a Channel for alert mentions under Who gets told in Settings. Members can see their alerts with /group-alerts list and remove one with /group-alerts remove. For quiet hours, see /group-alerts add.

Still stuck? Run /yourbot check in your server first: it lists every permission and setting the bot is missing. Then ask in our Discord with what you tried. Ask in Discord
Was this page helpful?
YourBot docs Reference tables are generated from the code that is running. Ask in Discord