Docs / Voice Channels / Commands / /voice prefs
Member Server only

/voice prefs

Remember how your rooms should start: name, limit, locked, hidden.

Usage

Generated
/voice prefs [name] [limit] [locked] [hidden] [clear]
OptionTypeRequiredDescription
name text No Name for your rooms (leave empty to keep) (1 to 90 characters)
limit whole number No User limit for your rooms, 0 for none (0 to 99)
locked yes or no No Start locked
hidden yes or no No Start hidden
clear yes or no No Forget everything remembered, including permit and reject lists

Who can run it

Generated
Discord defaultEvery member
Command Access presetEveryone
Always allowedThe server owner and, by default, Administrators
Change itDashboard, Services, Voice Channels, Commands

Meant for ordinary members. Open unless you lock it in Command Access. How Command Access works.

What the bot needs

Generated

Voice Channels is granted these permissions by the invite link. A command that finds one missing replies privately with what it could not do and changes nothing.

Manage ChannelsPriority SpeakerView ChannelConnectMute MembersDeafen MembersMove MembersManage Roles

Behaviour

Checked against the code 2026-10-11

Remembers how your future rooms on this server should start. It works anywhere in the server; you do not need to be in a room. Every option is optional: name (1 to 90 characters), limit (0 to 99, 0 for no limit), locked, hidden and clear.

Run it with no options to see what is saved, one line each: "Name: {v}", "Limit: {v}", "Locked at start: {v}", "Hidden at start: {v}" and "Remembered permits/rejects: {n}". Name and limit read "server default" when you have not set them. The two start lines read "yes" or "no"; a line you never set also reads "no", and the lobby then decides.

Give it one or more options and they are saved; options you leave out keep their previous value. The reply is "Saved. Your next room starts that way." Run it with clear:True to forget everything, including your remembered permits and rejects: "Forgotten. Your next room starts with the server defaults." Other options given together with clear:True are ignored.

Your preferences apply to the next room a lobby makes for you. A saved name replaces the name the room would get. That name is set on the New rooms page, "Room name", unless the lobby has its own on the Lobbies page, "A lobby's short name and what its rooms are called". A saved limit replaces the limit the room would start with. That limit is set on the New rooms page, "How many people a room holds and how it sounds", unless the lobby sets its own. A saved 0 means no limit even when the lobby has one. Saved locked and hidden values also win, in both directions, over how the lobby starts its rooms. That is set on the New rooms page, "Rooms start locked or hidden", unless the lobby sets its own on the Lobbies page, "How a lobby's rooms start". So locked:False opts you out of a lobby that starts rooms locked.

Good to know

  • Nothing changes in the room you are in right now. Use /voice rename, /voice limit, /voice lock and /voice hide for that.
  • There is no way to remove only the name or only the limit: leaving an option empty keeps it, so use clear:True and set the rest again.
  • Preferences are kept per server.
YourBot docs Reference tables are generated from the code that is running. Ask in Discord Suggest a correction