Sets a password (key) that users must provide to join the channel.
When to use it
Use a key when you want to share access with a word instead of inviting each person. Anyone who knows the key can join. Anyone who does not know it is turned away.
Usage
/mode +k secretpass Set channel key /mode -k Remove channel key /join #channel secretpass Join with key
The mode command changes the channel you are looking at. You do not type the channel name.
How it works
- The key is one word. It must match exactly, so upper and lower case letters matter.
- A person who joins without the key, or with the wrong key, is refused with a bad key error.
- People already in the channel stay there when you set or change the key.
- To remove the key, you do not need to type it again.
Channel Central
Operators can also open Channel Central, go to the Modes tab, tick Key, type the key and choose Apply Modes.
Rules and limits
- Only channel operators and owners can set or remove the key.
- An invitation does not replace the key. An invited person still needs it to join.
-
To join a keyed channel each time you connect, add it to your auto-join list with its key:
/autojoin add #channel secretpass - In a registered channel the key is saved and comes back after a restart.
See Also
Join Command · Invite Only · /autojoin · Channel Modes Overview