Bot Permissions

Last updated: 2026-04-19

When you click "Install to Discord", Discord asks you to authorize the KeepGrid bot with a set of permissions. Here is every permission we request, exactly why we need it, when we use it, and whether you can remove it after the install is done.

TL;DR: KeepGrid only uses permissions while actively installing or modifying structure. We do not read messages, monitor voice channels, or collect member data. You can remove permissions or remove the bot entirely after install — everything the bot created stays in your server untouched.

Permission Matrix

Permission	Why needed	Used when	Removable after install?
`Manage Channels`	Create the 30+ channel structure (Information, Community, Tickets, Voice, Staff categories).	Only during install and when you explicitly re-run with new config.	Yes. After install, you can remove this permission. The channels stay.
`Manage Roles`	Create the 9-role hierarchy (Owner → Pending) plus faction roles from your intake.	Only during install.	Yes. After install, remove this permission. Your roles stay.
`Manage Guild`	Only used to read basic guild info (name, icon) for progress UI. Never writes.	Once, during install bootstrap.	Yes. Can be removed immediately after install completes.
`View Channels`	Without it, the bot cannot see categories it just created to set permissions on them.	During install only.	Technically optional after install, but removing breaks future re-runs.
`Send Messages`	Post welcome message, server rules, how-to-join, and how-to-open-ticket content into the channels we create.	Once per created channel during install. Never ongoing.	Yes. Remove after install. Messages stay pinned.
`Embed Links`	The pinned welcome messages use embeds for readability.	Only alongside Send Messages during install.	Yes. Remove after install.
`Manage Messages`	Pin the welcome/rules/how-to messages so they stay at the top of their channels.	Only during install to pin. Never edits/deletes user messages.	Yes. Remove after install. Pins stay.
`Create Instant Invite`	Used only if you explicitly request a shareable invite link during install.	Opt-in feature only.	Yes. Can be removed — or never granted.
`Add Reactions`	Reaction-role setup in the welcome channel (opt-in).	Opt-in feature only.	Yes. Removable.

What the Bot Never Does

Never reads messages in any channel. We do not have, do not request, and never activate the Read Message History intent at a level that sees content.
Never monitors voice. No voice state tracking, no recording, ever.
Never collects member lists or user profile data.
Never uses Discord data to train AI models. This is prohibited by Discord Developer Policy.
Never acts on your server without you clicking a button. The bot has no background loops, no scheduled tasks, no webhooks firing on server events.

When Permissions Are Used

During install (~60-120 seconds)

The bot uses Manage Channels, Manage Roles, Send Messages, Embed Links, and Manage Messages in a single burst to build the server structure, set permissions, and pin documents. Every step is logged in your install progress view.

If you click "Re-install" or "Update"

Same permissions, same burst, but only affecting items that don't already exist (idempotent). Re-running is safe.

Ongoing / passive

None. After install, the bot sits silent in your server. It has no cron jobs, no message listeners, nothing. If you never re-run it, it never does anything.

Removing the Bot

At any point you can:

Right-click the bot in your Discord member list → Kick.
Or go to Server Settings → Integrations → KeepGrid → Remove.

Everything the bot created (channels, roles, permissions, pinned messages) remains intact. Removing the bot doesn't undo the install — your structure stays untouched.

One-Click Rollback (Installer 2.0)

If you want to fully undo an install, open that install's page in your KeepGrid dashboard and click "Roll back install". The bot will delete every channel, role, and pinned message it created during that install. Channels and roles that existed before the install are kept untouched. This typically takes under 30 seconds.

Before any install runs, KeepGrid takes a snapshot of your guild's existing channels and roles, and records the exact ID of every item it creates. Rollback uses this record to remove only what the bot added — never anything that was already there.

You can also preview the full install plan before authorizing the bot with the "Preview install plan" button. The preview shows every channel, role, and message that will be created, with nothing touched yet. Export the plan as JSON if you want to inspect it offline.

Reviewing Permissions in Discord

You can review or modify permissions at any time:

Open Server Settings.
Go to Integrations → KeepGrid → Manage.
Uncheck any permission you no longer want the bot to have.

Note: removing Manage Channels or Manage Roles after install will prevent re-running the installer or using dashboard-driven updates, but the current install remains intact.

Contact

If any permission feels unclear, or you want us to add a "no X permission" install mode for your use case: ops@keepgrid.net.