Entity Types

An entity type defines a category of objects in your database. Create one for each kind of thing you need to store — for example project, invoice, or product. The fields each entity carries are defined by property definitions, which are child entities of the entity type.

All configuration happens through the Entu UI — no code or config files.

Creating an Entity Type

1. Open Configuration in the sidebar
2. Add a new entity of type Entity
3. Fill in the parameters below

Entity Type Parameters

Param	Description
name	Internal identifier (e.g. project, invoice). Used in API queries — lowercase, no spaces.
label	Display name shown in the UI (e.g. Project, Invoice).
description	Explanation of what this entity type represents.
add_from	Which menus or parent entity types this type can be created under. Without this, the "Add" button won't offer this type anywhere. Reference one or more menu entities here.
_sharing	Maximum visibility for entities of this type: private (default), domain, or public. See Entities → Sharing.
plugin	Plugins attached to this entity type. See Plugins.

WARNING

If add_from is not set, users will have no way to create entities of this type through the UI. Always reference at least one menu or entity.

DANGER

Setting _sharing: public makes all entities of this type visible to anyone on the internet without authentication. Only use it for intentionally public content.

Adding Property Definitions

On the entity type's page, use the "Add" button to create child entities of type Property. Create one for each field entities of that type should have.

Property Definition Parameters

Param	Description
name	Internal key (e.g. first_name, due_date). Used in API queries. Must be unique within the entity type.
type	Data type — determines the UI input and how values are stored. See Property Types below.
label	Display name shown above the field.
label_plural	Plural label shown when the field has multiple values (e.g. Tags instead of Tag).
ordinal	Numeric sort order within the group. Lower numbers appear first.
group	Groups related fields into named sections on the entity page and in the edit form.
description	Help text shown in an info popover next to the field label.
mandatory	Marks the field as required — always shown with a red indicator when empty.
readonly	Visible on the entity page but not editable through the UI.
hidden	Hides the field from the edit form but still shows its value on the entity page. Use for formula-driven or integration-managed fields.
formula	A server-side expression evaluated and written on every save. See Formulas.
default	Pre-filled value when creating a new entity.
list	Allows multiple values. Extra inputs appear automatically as the user fills them in.
multilingual	Stores a separate value per language. A language selector appears next to each input.
markdown	Enables markdown rendering for text type fields.
decimals	Number of decimal places for number type fields.
set	Restricts input to a fixed list — renders a dropdown instead of free text. Pair with string type.
reference_query	Filters which entities are selectable in a reference field (e.g. _type.string=person).
_sharing	Visibility of this field's values. Cannot exceed the entity type's own _sharing.
search	Indexes values for full-text search. Enable on fields users naturally search by.
plugin	Attaches a plugin at the field level for custom UI or behavior.

TIP

Enable search on properties users frequently filter by (e.g. name, status, reference code).

Property Types

Type	Input	Notes
string	Single-line text	If set is defined, renders as a dropdown instead.
text	Multi-line textarea	Auto-resizes between 3–15 rows. Enable markdown for rich formatting.
number	Number input	Locale-formatted. Use decimals to control precision.
boolean	Toggle switch	Stores true/false.
date	Date picker	Stores date only — no time component.
datetime	Date + time picker	Stores a full timestamp.
file	File upload	Stores a file attachment. See Files.
reference	Entity selector	Links to another entity. Use reference_query to filter selectable options.
counter	Auto-generated code	Read-only. Shows a generate button when empty; displays the value once assigned. Use for invoice numbers, project codes.

Example: "Project" Entity Type

Entity type:

Param	Value
name	project
label	Project
description	A client project or internal initiative
add_from	(reference to the "Projects" menu)

Property definitions (child entities):

name	type	label	Notable settings
name	string	Name	mandatory, search
status	string	Status	set: ["Planning", "Active", "On Hold", "Done"], mandatory
description	text	Description	markdown
owner	reference	Owner	reference_query: _type.string=person
due_date	date	Due Date
budget	number	Budget	decimals: 2
tags	string	Tag	label_plural: Tags, list
code	counter	Project Code	readonly
notes	text	Internal Notes	hidden
total_hours	number	Total Hours	formula, readonly, decimals: 1