Entity Picker

Using the entity picker property editor with Konstrukt, the back office UI builder for Umbraco.

The Entity Picker property editor is an Umbraco property editor that lets you select one or more entities from a Konstrukt collection.

Configuring an entity picker

To configure an entity picker you'll firstly want to create a data type in the Umbraco back office choosing 'Konstrukt Entity Picker' from the property editor dropdown.

Datatype config

From there choose the 'Section' and then 'Collection' you'd like to pick entities from, as well as an optional list view 'Data View' if there are any configured.

You can also set a minimum and maximum number of items to be able to pick if required.

With an entity picker data type defined, finish off the configuration by adding it to the desired document type definition.

Doctype config

Using an entity picker

Using the entity picker should be pretty familiar as it aims to mimic the content picker as closely as possible.

To pick an entity click the 'Add' link to launch the picker dialog. The dialog should present a paginated list of entities to pick from. If any searchable fields have been configured for the entity type, you can also perform a search by typing a search term in the search input field.

Entity picker dialog

To pick your items simply click on the entity names and then click 'Select' in the bottom right hand corner.

The picker should display a summary of the selected entities and can be sorted by dragging the selected entities into the desired order.

Entity picker values

To save the value either save or save and publish the current document.

Getting the value of an entity picker

The entity picker property editor comes with a built in value converter meaning that whenever you retrieve the property value from Umbraco it will return the actual selected entities, even converting them to the relevant type.

// Example
foreach(var p in Model.People){
    ...
}