ChanServ Commands

ChanServ allows you to register and control various aspects of channels. ChanServ can often prevent malicious users from "taking over" channels by limiting who is allowed channel operator privileges. Available commands are listed below; to use them, type /msg chanserv command. For more information on a specific command, type /msg chanserv help command.

ACCESS: Maintains the access list for a channel. The access list specifies which users are allowed chanop status or access to ChanServ commands on the channel. Different user levels allow for access to different subsets of privileges; /msg chanserv help access levels for more specific information. Any nick not on the access list has a user level of 0.

ADD: /msg chanserv access #channel add nick level
Adds the given nickname to the access list with the given user level; if the nick is already present on the list, its access level is changed to the level specified in the command. The level specified must be less than that of the user giving the command, and if the nick is already on the access list, the current access level of that nick must be less than the access level of the user giving the command.

DEL: /msg chanserv access #channel del {nick|entry-num|list}
Removes the given nick from the access list. If a list of entry numbers is given, those entries are deleted. (See the example for LIST below.)

LIST: /msg chanserv access #channel list {mask|list}
Displays the access list. If a wildcard mask is given, only those entries matching the mask are displayed. If a list of entry numbers is given, only those entries are shown; for example: /msg chanserv access #help list 2-5,7-9 Lists access entries numbered 2 through 5 and 7 through 9.

CLEAR: /msg chanserv access #channel clear
Clears all entries of the access list.

AKICK: Maintains the Auto Kick list for a channel. If a user on the Auto Kick list attempts to join the channel, ChanServ will ban that user from the channel, then kick the user.

ADD: /msg chanserv akick #channel add mask reason
Adds the given nick or usermask to the Auto Kick list. If a reason is given with the command, that reason will be used when the user is kicked; if not, the default reason is "You have been banned from the channel".

STICK: /msg chanserv akick #channel stick mask
Permanently bans the given mask on the channel. If someone tries to remove the ban, ChanServ will automatically set it again. You can't use it for registered nicks.

UNSTICK: /msg chanserv akick #channel unstick mask
Cancels the effect of the AKICK STICK command, so you'll be able to unset the ban again on the channel.

DEL: /msg chanserv akick #channel del mask
Removes the given nick or mask from the Auto Kick list. It does not, however, remove any bans placed by an Auto Kick; those must be removed manually.

LIST: /msg chanserv akick #channel list mask
Displays the Auto Kick list, or optionally only those Auto Kick entries which match the given mask.

VIEW: /msg chanserv akick #channel view mask
The AKICK VIEW command is a more verbose version of AKICK LIST command.

ENFORCE: /msg chanserv akick #channel enforce
Causes ChanServ to enforce the current AKICK list by removing those users who match an AKICK mask.

CLEAR: /msg chanserv akick #channel clear
Clears all entries of the akick list.

AOP: Maintains the AOP (AutoOP) list for a channel. The AOP list gives users the right to be auto-opped on your channel, to unban or invite themselves if needed, to have their greet message showed on join, and so on.

ADD: /msg chanserv aop #channel add nick
Adds the given nickname to the AOP list.

DEL: /msg chanserv aop #channel del {nick|entry-num|list}
Removes the given nick from the AOP list. If a list of entry numbers is given, those entries are deleted. (See the example for LIST below.)

LIST: /msg chanserv aop #channel list {mask|list}
Displays the AOP list. If a wildcard mask is given, only those entries matching the mask are displayed. If a list of entry numbers is given, only those entries are shown; for example: AOP #channel LIST 2-5,7-9 Lists AOP entries numbered 2 through 5 and 7 through 9.

CLEAR: /msg chanserv aop #channel clear
The AOP CLEAR command clears all entries of the AOP list.
Note: The AOP ADD and AOP DEL commands are limited to SOPs or above, while the AOP CLEAR command can only be used by the channel founder. However, any user on the AOP list may use the AOP LIST command. This command may have been disabled for your channel, and in that case you need to use the access list. See /msg chanserv HELP ACCESS for information about the access list, and /msg chanserv HELP SET XOP to know how to toggle between the access list and xOP list systems.

BAN: /msg chanserv ban #channel nick reason
Bans a selected nick on a channel. If nick is not given, it will ban you. If channel and nick are not given, it will ban you on all channels you're on, provided you have the rights to. By default, limited to AOPs or those with level 5 access and above on the channel. Note: Extended Bans are now available. Please see the FAQ topic, How do I use the Extended Ban Types? for more information.

CLEAR: Tells ChanServ to clear certain settings on a channel. what can be any of the following:

MODES: /msg chanserv clear #channel modes
Resets all modes on the channel (i.e. clears modes i,k,l,m,n,p,s,t).
BANS: /msg chanserv clear #channel bans
Clears all bans on the channel.
OPS: /msg chanserv clear #channel ops
Removes channel-operator status (mode +o) from all channel operators.

VOICES: /msg chanserv clear #channel voices
Removes "voice" status (mode +v) from anyone with that mode set.

USERS: /msg chanserv clear #channel users
Removes (kicks) all users from the channel. By default, limited to those with founder access on the channel.

DEHALFOP: /msg chanserv dehalfop #channel nick
Dehalfops a selected nick on a channel. If nick is not given, it will dehalfop you. If channel and nick are not given, it will dehalfop you on all channels you're on, provided you have the rights to. By default, limited to AOPs and those with level 5 access and above on the channel, or to HOPs or those with level 4 and above for self dehalfopping.

DEOP: /msg chanserv deop #channel nick
Deops a selected nick on a channel. If nick is not given, it will deop you. If channel and nick are not given, it will deop you on all channels you're on, provided you have the rights to. By default, limited to AOPs or those with level 5 access and above on the channel.

DEOWNER: /msg chanserv deowner #channel
Removes your owner status on channel. If channel is not given, it will remove your owner status on all channels you're on, provided you have the rights to. Limited to those with founder access on the channel.

DEPROTECT: /msg chanserv deprotect #channel nick
Deprotects a selected nick on a channel. If nick is not given, it will deprotect you. If channel and nick are not given, it will deprotect you on all channels you're on, provided you have the rights to. By default, limited to the founder, or to SOPs or those with level 10 and above on the channel for self deprotecting.

DEVOICE: /msg chanserv devoice #channel nick
Devoices a selected nick on a channel. If nick is not given, it will devoice you. If channel and nick are not given, it will devoice you on all channels you're on, provided you have the rights to. By default, limited to AOPs or those with level 5 access and above on the channel, or to VOPs or those with level 3 and above for self devoicing.

DROP: /msg chanserv drop #channel
Cancel the registration of a channel Can only be used by channel founder, who must use the IDENTIFY command first.

GETKEY: /msg chanserv getkey #channel
Returns the key of the given channel. This is a command mainly intended to be used by bots and/or scripts, so the output is in the following way: KEY channel key. key is "NO KEY" if no key is set.

HALFOP: /msg chanserv halfop #channel nick
Halfops a selected nick on a channel. If nick is not given, it will halfop you. If channel and nick are not given, it will halfop you on all channels you're on, provided you have the rights to. By default, limited to AOPs and those with level 5 access and above on the channel, or to HOPs or those with level 4 and above for self halfopping.

HOP: Maintains the HOP (HalfOP) list for a channel. The HOP list gives users the right to be auto-halfopped on your channel.

ADD: /msg chanserv hop #channel add nick
Adds the given nickname to the HOP list.
DEL: /msg chanserv hop #channel del {nick|entry-num|list}
Removes the given nick from the HOP list. If a list of entry numbers is given, those entries are deleted. (See the example for LIST below.)

LIST: /msg chanserv hop #channel list {mask|list}
Displays the HOP list. If a wildcard mask is given, only those entries matching the mask are displayed. If a list of entry numbers is given, only those entries are shown; for example: HOP #channel LIST 2-5,7-9 Lists HOP entries numbered 2 through 5 and 7 through 9.

CLEAR: /msg chanserv hop #channel clear
Command clears all entries of the HOP list.
The HOP ADD, HOP DEL and HOP LIST commands are limited to AOPs or above, while the HOP CLEAR command can only be used by the channel founder. This command may have been disabled for your channel, and in that case you need to use the access list. See /msg chanserv help access for information about the access list, and /msg chanserv help set xop to know how to toggle between the access list and xOP list systems.

IDENTIFY: /msg chanserv identify #channel password
Authenticates you to ChanServ as the founder of the given channel. Many commands require you to use this command before using them. The password should be the same one you sent with the REGISTER command.

INFO: /msg chanserv info #channel [ALL]
Lists information about the named registered #channel, including its founder, time of registration, last time used, description, and mode lock, if any. If ALL is specified, the entry message and successor will also be displayed. By default, the ALL option is limited to those with founder access on the channel.

INVITE: /msg chanserv invite #channel
Tells ChanServ to invite you into the given channel. By default, limited to AOPs or those with level 5 and above on the channel.

KICK: /msg chanserv kick #channel nick reason
Kicks a selected nick on a channel. If nick is not given, it will kick you. If channel and nick are not given, it will kick you on all channels you're on, provided you have the rights to. By default, limited to AOPs or those with level 5 access and above on the channel.

LEVELS: Allows fine control over the meaning of the numeric access levels used for channels. With this command, you can define the access level required for most of ChanServ's functions. (The SET FOUNDER and SET PASSWORD commands, as well as this command, are always restricted to the channel founder.) For a list of the features and functions whose levels can be see /cs help levels desc

SET: /msg chanserv levels #channel set type level
Allows the access level for a function or group of functions to be changed.

DISABLE: /msg chanserv levels #channel {dis|disable} type
Disables an automatic feature or disallows access to a function by anyone other than the channel founder.

LIST: /msg chanserv levels #channel list
Shows the current levels for each function or group of functions.

RESET: /msg chanserv levels #channel reset
Resets the levels to the default levels of a newly-created channel (see /msg chanserv help access levels).
For a list of the features and functions whose levels can be set, see /msg chanserv help levels desc.

LOGOUT: /msg chanserv logout #channel nick
This command makes the selected nickname not identified anymore for the given channel. If you are the founder of the channel, you can log out anybody, else you can only log out yourself.

MODE: /mode #channel mode
Used to change the mode of a channel. You can only change modes for channel you are an Operator or Half-Op on.