Documentation

Everything you need to set up multilingual channels with BabelWeave.

Quick start

Invite BabelWeave

Click Add to Discord in the nav. Grant the requested permissions.

Create a translation group

/translate group create name:global-chat

A group links a set of language channels together.

Add language channels

/translate channel add group:global-chat channel:#english language:en

/translate channel add group:global-chat channel:#español language:es

Repeat for each language. The bot creates a role and locks visibility automatically.

Post the role panel

/translate roles setup channel:#role-selection

Members self-select their languages. The 🌐 button auto-detects from Discord locale.

Test

Send a message in #english — it should appear translated in #español within ~2 seconds.

Category-based setup (large servers)

For servers where each language lives in its own Discord category (🇬🇧 English, 🇫🇷 Français, etc.):

Create your base category

Create a category (e.g. 🇬🇧 English) in Discord and add channels inside it.

Register the category

/translate category register category:🇬🇧 English language:en

Clone to new languages

/translate category clone source:🇬🇧 English language:fr

The bot creates a new category with translated channel names and wires up translation groups.

⭐ Category cloning requires a Pro or Premium plan.

Command reference

Command	Description
/translate group create	Create a translation group
/translate group delete	Delete a group and all its channels
/translate group list	List all groups in this server
/translate channel add	Add a channel to a group
/translate channel remove	Remove a channel from its group
/translate channel backfill	Backfill recent history (Pro+)
/translate roles setup	Post a server-wide role selection panel
/translate roles refresh	Update the existing role panel
/translate roles sync-all	Sync roles for all managed groups
/translate category register	Register a category as a language container
/translate category clone	Clone a category to a new language (Pro+)
/translate category list	List registered categories
/translate category sync	Reapply category visibility
/translate status	Show plan, usage, and upgrade options
/translate me	Set your language from your Discord locale

Role hierarchy

The bot's role must be positioned above all language roles in Server Settings → Roles. If it's not, the bot cannot assign or remove language roles, and /translate roles setup will warn you.

Limits by plan

Run /translate status in your server to see your current plan, today's usage, and upgrade options. Daily relay counts reset at UTC midnight.