Go to: Return value. Related commands. Flags. Examples.

Synopsis

connectAttr [-l true|false] [-f] [-na] sourceAttribute destinationAttribute

Connect the attributes of two dependency nodes and return the names of the two connected attributes. The connected attributes must be be of compatible types.

(Refer to dependency node documentation.)

Return value

string: A phrase containing the names of the connected attributes.

Related commands

connectionInfo, isConnected, listConnections

Flags

force, lock, nextAvailable, referenceDest

Long name (short name)[argument types]Properties
-lock (-l) booleancreate
If the argument is true, the destination attribute is locked after making the connection. If the argument is false, the connection is unlocked before making the connection.
-force (-f) create
Forces the connection. If the destination is already connected, the old connection is broken and the new one made.
-nextAvailable (-na) create
If the destination multi-attribute has set the indexMatters to be false with this flag specified, a connection is made to the next available index. No index need be specified.
-referenceDest (-rd) stringcreate
This flag is used for file io only. The flag indicates that the connection replaces a connection made in a referenced file, and the flag argument indicates the original destination from the referenced file. This flag is used so that if the reference file is modified, maya can still attempt to make the appropriate connections in the main scene to the referenced object.
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

Examples

		createNode transform -n firstGuy;
		createNode transform -n secondGuy;

		// Connect the translation of two nodes together
		connectAttr firstGuy.t secondGuy.translate;
		
		// Connect the rotation of one node to the override colour
		// of a second node.
		connectAttr firstGuy.rotate secondGuy.overrideColor;