create_collection

create_collection(name='NewCollection', parent=None)

Create a new Blender collection or get an existing one.

A collection that doesn’t exist yet is created and linked to the active scene’s collection. An existing collection is returned without changing where it is linked, unless a parent is given.

Parameters

Name	Type	Description	Default
name	str	The name of the collection to create or get. Default is “NewCollection”.	'NewCollection'
parent	Collection or str or None	The collection to link the collection into, which also unlinks it from the scene’s collection. A string is the name of the parent collection, which is created and linked to the scene if it doesn’t exist. Default is None, which leaves the collection where it is.	None

Returns

Name	Type	Description
	Collection	The created or existing collection.

Raises

Name	Type	Description
	TypeError	If parent is not a Collection, string or None.