Go to: Synopsis. Return value. Related. Flags. MEL examples.

Synopsis

disconnectAttr [-nextAvailable] sourceAttribute destinationAttribute

disconnectAttr is undoable, queryable, and editable.

Disconnects two connected attributes.

Return value

string A phrase containing the names of the disconnected attributes.

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

Related

addAttr, connectAttr, getAttr, listAttr, setAttr

Flags

nextAvailable
Long name (short name) argument types Properties
-nextAvailable(-na) create
If the destination multi-attribute has set the indexMatters to be false, the command will disconnect the first matching connection. No index needs to be specified.
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 be used more than once in a command

MEL examples

//    Create a sphere and cone and connect their rotate attribute.
//
string $sph[] = `sphere`;
string $con[] = `cone`;
connectAttr ($sph[0] + ".r") ($con[0] + ".r");

//    Break the connection between the rotate attributes.
//
disconnectAttr ($sph[0] + ".r") ($con[0] + ".r");