An instance is a piece of data conforming to a model. If Customer is the model, then Acme Corp. is an instance of Customer.

Lifecycle

  • Create — open the model in the Explorer, click + New, fill the form, save. The form is built from the model's properties and constraints.
  • Read — list instances with filtering and pagination. Click one to open it.
  • Update — edit the form. Yellow tracks who changed what and when.
  • Delete — soft-delete by default; some workflows keep history forever.

Ownership

Every instance has audit fields:

  • createdOn / createdBy — when and by whom it was created.
  • updatedOn / updatedBy — last change.

These are managed by Yellow automatically.

Files attached to instances

Any instance can have files attached to it: contracts, images, exports, anything. Files live in a per-instance file space and can be organised into folders (including the conventional docs/ folder for documentation).

Bookmarks

Mark frequently-used instances as bookmarks so they appear on the Dashboard's Bookmarks widget.