API Reference › core-backend› ViewDefinitions › CategorySelector › Insert

insert MethodStatic

Insert a CategorySelector to select which categories are displayed by a ViewDefinition.

insert(iModelDb: IModelDb, definitionModelId: string, name: string, categories: Id64Array): string

@returns The Id of the newly inserted CategorySelector element.

@throws IModelError if unable to insert the element.

Parameter Type Description
iModelDb IModelDb Insert into this iModel
definitionModelId string Insert the new CategorySelector into this DefinitionModel
name string The name of the CategorySelector
categories Id64Array Array of categories to select for display

Returns - string

The Id of the newly inserted CategorySelector element.

Defined in

Last Updated: 24 October, 2025