Konstrukt
🚨 Konstrukt is now Umbraco UI Builder 🚨
  • Konstrukt Documentation
  • Getting Started
    • Overview
    • Installation
    • Configuration
    • User Interface
  • Guides
    • Creating your first integration
  • Areas
    • Overview
    • Sections
      • Summary Dashboards
    • Trees
      • Folders
    • Dashboards
    • Context Apps
  • Collections
    • Overview
    • The Basics
    • List Views
      • Field Views
    • Editors
    • Child Collections
      • Child Collection Groups
  • Searching
    • Overview
    • Searchable Properties
  • Filtering
    • Overview
    • Global Filters
    • Data Views
      • Data Views Builders
    • Filterable Properties
  • Actions
    • Overview
    • The Basics
    • Action Visbility
    • Inbuilt Actions
  • Cards
    • Overview
    • Count Cards
    • Custom Cards
  • Property Editors
    • Overview
    • Entity Picker
  • Advanced
    • Virtual Sub Trees
    • Encrypted Properties
    • Value Mappers
    • Repositories
    • Events
  • Extras
    • Conventions
    • Umbraco Aliases
    • Konstrukt vs UI-O-Matic
    • Known Issues
    • Changelog
Powered by GitBook
On this page
  • Configuring an entity picker
  • Using an entity picker
  • Getting the value of an entity picker
Edit on GitHub
  1. Property Editors

Entity Picker

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

PreviousOverviewNextVirtual Sub Trees

Last updated 3 years ago

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.

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.

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.

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.

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

Getting the value of an entity picker

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

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

value converter
Datatype config
Doctype config
Entity picker dialog
Entity picker values