Manage records on a CRUD engine console page
Pages whose data line ends in "(CRUD engine entity ...)" are generated from one definition of the table: the buttons you see are exactly the operations the server performs for you, nothing more.
Have questions or need step-by-step guidance on this topic?
Step-by-Step Procedure
Recognise an engine page
Under the page title the data line reads "Live: <table> (CRUD engine entity <key>)", for example "Live: i8_issues (CRUD engine entity system.issues)".
Read the buttons as a promise
"New Record", the pencil (edit), the bin (Archive, Remove or Delete), "Restore", the row checkboxes and the CSV/JSON buttons appear only when the engine implements that operation for this table AND your role may use it. A page without them is read-only for you.
Find records
Search, the status filter and the extra filter dropdowns run in the database over all records. Click a column header with an arrow to sort; click again to reverse. The pagination bar shows the true total.
Create and edit
The form is generated from the table definition: required fields are marked *, choices are dropdowns, links to other records are searchable pickers, JSON fields take JSON text. The server checks every value again and names any field it refuses; nothing is saved until all are valid.
Archive, remove or delete
The bin button says what really happens. "Archive" keeps the record and its history out of the active list (choose the archived status in the filter to see it, then "Restore"). "Remove" hides it (soft delete) and can be restored. "Delete" is permanent and is only offered for records with no history.
Bulk actions
Tick rows, or the header box for the whole page, and use the bulk bar. Each page states its maximum per request; every record is processed and audited on its own, and the banner lists any that were refused and why.
Export
Click "CSV" or "JSON" to download every record that matches the current search and filters (not only this page). Write-only fields such as secrets are never exported. The export is recorded in the audit ledger.
You can create, find, edit, archive or restore records where the page allows it, and every change is recorded in the audit ledger with what changed and who changed it.
Troubleshooting & Failure Modes
Was this guide helpful?
Help us refine our platform documentation