API Reference › core-backend› IModels › DrawingCategory › Insert

insert MethodStatic

Insert a new DrawingCategory

insert(iModelDb: IModelDb, definitionModelId: string, name: string, defaultAppearance: SubCategoryAppearance | SubCategoryAppearance.Props): string

@returns The Id of the newly inserted DrawingCategory element.

@throws IModelError if unable to insert the element.

Parameter Type Description
iModelDb IModelDb Insert into this iModel
definitionModelId string Insert the new DrawingCategory into this DefinitionModel
name string The name of the DrawingCategory
defaultAppearance SubCategoryAppearance | SubCategoryAppearance.Props The appearance settings to use for the default SubCategory of this DrawingCategory

Returns - string

The Id of the newly inserted DrawingCategory element.

Defined in

Last Updated: 24 October, 2025