dropbits Documentation

Entities & records

Listings show records from an entity (a typed table: articles, events, …). Schema changes are site-wide — every listing or detail page using that entity picks them up.

Schema vs rows

NeedWhere
Add a field, rename a label, change optionsHub → Entities (schema). Also: Layout-armed listing bar → Edit schema.
Create / edit / delete rowsA listing on the page, or a staff page under Hub → Records.

A warning in the schema dialog reminds you: this is not a per-widget tweak. Prefer adding fields only when every listing of that entity should grow — otherwise leave schema alone and hide columns with Fields on that widget (see Layout compose).

Relation / many: pick a target entity and label field. For many, also set the junction table and left/right keys (the junction entity must already exist — create it separately or ask the Assistant). Incomplete relation meta falls back to a lean id picker.

Create a record on a listing

  1. Open the page that shows the listing (public listing or a staff page under Records).
  2. Sign in with a role that can edit.
  3. Use + Create record (wording may say Add). A form opens for the entity’s editable fields.
  4. Fill required fields → save. The new row appears in the list.
  5. If Detail is on for that listing, open the row to edit the full detail page.

Some listings disable create (for example the account page). Staff listings often auto-arm so Delete and in-place edit are ready without an extra click.

If the entity has a slug field and you leave it blank, Dropbits fills it from title or name when present, otherwise from the first text field. Edit the slug only for a custom URL.

You can also edit rows on the public listing (same entity). Records pages are the quiet staff URL: gated (Editors or Admin), not in the visitor menu.

Users is the login table as a listing (Admin-only). Account is your own row. See Log in & roles.

Listing bar (this widget only)

With ⊞ Layout armed on a listing: Template, Filter, Fields, page length, Search, Detail, and Edit schema. Filter and Fields change this widget’s presentation; Edit schema opens the shared entity. Full control list: Layout compose.

See also