Getting started with YSF Utils

A practical setup path for Discord authentication, guild permissions, configuration, and troubleshooting.

1. Connect your account

Sign in with Discord. YSF Utils requests identity and guild-list access so the dashboard can display servers you are allowed to manage. Your Discord access token stays in an HTTP-only cookie.

2. Select a guild

Open the dashboard and choose a server where you have management permissions. If a server is missing, confirm your Discord permissions and refresh the connection.

3. Review bot permissions

Place the bot role high enough to manage only the roles and channels required by your workflow. Avoid granting Administrator when narrower permissions are sufficient.

4. Configure and test

Save one change at a time, use the guild health checklist, and test in a private channel before enabling the workflow for the whole community.

Troubleshooting

A guild is missing
Confirm that you are signed into the intended Discord account and have Manage Server permission, then sign out and reconnect.
A command is denied
Review channel overrides and the bot role position. Discord channel permissions can override server-level permissions.
Setup still fails
Check the public status page, then contact support with the guild ID, affected workflow, and a timestamp. Never send a token or password.
Open support center