ProjectHelm
Home / Documentation / Relations & Cascading Dropdowns
Data Modeling

Relations & Cascading Drops

BelongsTo dropdowns, server-side typeaheads, HasMany child tabs, inline editing, and cascading selects.

Updated September 2026 • 5 min read • .NET 10 & C#

BelongsTo Relationships

A record points to another record (e.g. Order belongs to Customer). Supported dropdown modes:

  • ServerSearch: High-performance async typeahead for tables with thousands or millions of rows.
  • Static: Standard HTML select dropdown for small sets (e.g. Departments, Statuses).
  • StaticSearchable: Searchable in-memory dropdown with instant text filtering.

HasMany Child Tables, Tabs & Repeaters

Parent entities display their child records either as dedicated tabs, inline overview tables, interactive dual-pane list views, or dynamic line-item repeaters:

  • Repeater Line-Items: (hasManyDisplayMode: "Repeater") Embeds a dynamic line-items table directly inside Create and Edit forms. Users add, modify, and delete child rows on the fly, saving the parent and its line items atomically in a single database transaction without having to save the parent record first. Ideal for Orders, Invoices, Quotes, and Expense Reports.
  • Inline Overview: Displays child tables directly in the parent record overview. With allowInlineCreate: true, child items can be added directly via an inline modal.
  • Tabbed Layout: Separates each child collection into its own tab on the Details view for clean, uncluttered record inspection.
  • Relationship List View: Dual-pane selectable picker for assigning many-to-many associations and junction entities (e.g. Categories, Skills, Tags).

Cascading Dropdowns

Easily link related dropdowns: selecting a Country automatically restricts the State dropdown to matching records via cascadeFromRelationName.