Go to: Synopsis. Return value. Keywords. Related. Flags. Python examples.


mute([disable=boolean], [force=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

mute is undoable, queryable, and NOT editable.

The mute command is used to disable and enable playback on a channel. When a channel is muted, it retains the value that it was at prior to being muted.

Return value

string[]Name(s) of the mute node(s)

In query mode, return type is based on queried flag.


mute, animation, channels




disable, force
Long name (short name) Argument types Properties
disable(d) boolean create
Disable muting on the channels
force(f) boolean create
Forceable disable of muting on the channels. If there are keys on the mute channel, the animation and mute node will both be removed. If this flag is not set, then mute nodes with animation will only be disabled.

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

# Mute playback of the ry channel of ty on the sphere
sph = cmds.polySphere()
cmds.setKeyframe( '%s.translate' % sph[0] )
cmds.mute( '%s.translateY' % sph[0] )
# Query whether ty is muted
cmds.mute('%s.translateY' % sph[0], q=True )
# Disable muting on any muted attributes on the sphere
cmds.mute( sph[0], disable=True )