Skip to main content
An entity is anything in Custral that can be owned, shared, and given permissions. Almost everything you work with is an entity: objects, pages, views, records, and channels all qualify. Treating them all the same way is what lets one permission model cover your entire workspace.

​
What counts as an entity

Because each of these is an entity, the same sharing and access controls apply everywhere. You don’t learn a separate system for objects, pages, and channels.

​
Why entities matter

Entities are the unit that permissions attach to. When you share a deal, restrict a dashboard, or give a team access to an object, you’re placing an access grant on that entity. Each entity carries its own list of who can see and do what, and that list can either be inherited from a parent entity or set independently. Entities are arranged in a hierarchy that mirrors your workspace: for example, Workspace → Object → Record, or Section → Page → View. Access flows down this hierarchy by default, so a permission set on a parent reaches its children unless you override it lower down. This is what makes it possible to manage access across thousands of records without touching each one.

​
How entities relate to Surfaces

A Surface always begins from an entity, either a Page or an Object. The entity is the entry point; the views and components built on it are how its data becomes interactive.

​
See also

Surfaces Overview

Permissions Overview

Access Levels

Views Overview