Remove

Deprecated

This item is deprecated in favor of Instance/Destroy and Instance/ClearAllChildren. If you must remove an object from the game, and wish to use the object later, set its Parent property to nil instead of using this method.

Unsafe

For thread safety, this property is not safe to read in an unsynchronized thread.

Function of:

Instance

Description:

The Remove function sets the object’s Instance/Parent to nil, and does the same for all its descendants.

If the object is referenced before being removed it is possible to retrieve the object at a later point.

Returns

Return Type	Summary
Return Type void	Summary

Code Samples

Instance:Remove

The following code demonstrates how a part can be re-added to the DataModel after being removed:

			
				Instance:Remove

				Expected Output
			
				Expand
				
			local part = Instance.new("Part", Workspace)
print(part.Parent)
--> Workspace

part:Remove()
print(part.Parent)
--> nil

part.Parent = Workspace
print(part.Parent)
--> Workspace
		
				Copy Code
			
				Light Theme

Remove

Returns

void

Code Samples

Instance:Remove