insert MethodStatic


insert(txn, definitionModelId, materialName, params) @beta

Insert a new RenderMaterial into a model.

insert(txn: EditTxn, definitionModelId: string, materialName: string, params: RenderMaterialElementParams): string

@returns The Id of the newly inserted RenderMaterial element.

@throws IModelError if unable to insert the element.

Parameter Type Description
txn EditTxn The EditTxn to use
definitionModelId string Insert the new Texture into this DefinitionModel
materialName string The name/CodeValue of the RenderMaterial
params RenderMaterialElementParams Parameters object which describes how to construct the RenderMaterial

Returns - string

The Id of the newly inserted RenderMaterial element.



insert(iModelDb, definitionModelId, materialName, params)

Deprecated  in 5.1.9 - will not be removed until after 2027-05-04. Use RenderMaterialElement.insert(txn, ...) instead.

Insert a new RenderMaterial into a model.

insert(iModelDb: IModelDb, definitionModelId: string, materialName: string, params: RenderMaterialElementParams): string

Parameter Type Description
iModelDb IModelDb  
definitionModelId string  
materialName string  
params RenderMaterialElementParams  

Returns - string


Defined in

Last Updated: 07 May, 2026