Common issues + how to fix them.

The install page has a 1-click Retry button at the top. Click it. The installer is idempotent — it picks up from the step that failed and skips items that already exist.

If retry also fails, look at the install log on the page (click the Install Log link). The log shows each step and the exact Discord error if any. Most common causes:

• Bot role positioned too low — Server Settings → Roles → drag KeepGrid up. The bot can't manage roles ranked above it.
• 50013 Missing Permissions — see Permission flags. Re-invite the bot if needed.
• Server full — Discord caps free servers at 500 channels and 250 roles. Most KeepGrid installs need ~30 channels + 9 roles, so this is rare.

If you want to start clean, click Roll back on the dashboard. KeepGrid deletes only what it created (tracked in the install log) and leaves any pre-existing channels alone.

The dashboard shows the missing flag explicitly — e.g. Missing: MANAGE_GUILD. Open Server Settings → Roles → KeepGrid and toggle the missing flag on, then click Check bot permissions on the Fix Preview again.

If you don't want to grant the flag, that's fine — apply the fix manually using the steps in the Fix Preview block. KeepGrid never executes a fix without the right scope.

See Permission flags KeepGrid needs for the full table.

Two possibilities:

1. The fix was idempotent and the underlying state was already correct. Check the audit log — if afterState equals beforeState, the bot didn't need to do anything. Some else may need to change first (e.g. enabling Community Server before #no-welcome-screen).
2. The scan caches results for 5 min. Click Run scan now on the Ops Health card to force a fresh scan. The fix you just applied should now register as resolved.

If the fix shows status=success in audit log but the finding persists across multiple scans, email ops@keepgrid.net with the audit log id.

Check in this order:

1. Spam folder. First-time KeepGrid emails sometimes filter — mark as not-spam to whitelist.
2. Pro is active. Email reports require an active Pro subscription on a project with a complete install.
3. Email on the project matches what you check. Reports go to the email associated with the project owner, not necessarily your account email.
4. The first scheduled scan hasn't happened yet. Reports send Mondays at 14:00 UTC. New Pro signups don't get a backfill — first email is the Monday after signup.

You can trigger a one-off email by running an on-demand scan from the dashboard. The action-plan email format is the same.

The audit log only records Pro Fix Button executions. If you haven't clicked any Fix Buttons, the log is empty by design — that's correct, not a bug.

If you DO see Fix Button history elsewhere (e.g. Discord's native audit log shows the bot's changes) but the KeepGrid audit log is empty, that means the executions ran on a different project. Check the dashboard's project picker — fixes are scoped per-project.

503 usually means a Stripe price ID env variable is missing. Reach out to ops@keepgrid.net with a screenshot — KeepGrid configures these per-deployment.

Wrong price displayed: rare, but happens if Stripe price IDs were rotated. Hard refresh, then if the price is still wrong, email us.

The generation is tuned to your intake — server name, RP style, staff size, factions. If the docs feel generic, the most common cause is a sparse intake. Re-open the project, fill out the "active factions" field with specifics, add server stage detail, and click Regenerate documents.

If the regeneration still doesn't hit the mark, the Done-for-you tier ($349 beta) is the right fit — we walk through your community on a 60-min call and tune the system live.

Roll back deletes only what KeepGrid created during install (tracked in the install log). It does NOT delete:

• Channels or roles that existed before install (matched by name, skipped during install)
• Channels you created manually after install
• Messages — only deletes channels, which removes their messages

If roll back missed something you wanted removed, delete it manually in Discord. If roll back deleted something you wanted to keep, sorry — restoration of deleted Discord resources is not possible. The pre-install snapshot lets you recreate the structure but messages are gone.