← Back to How do I write a new standard?
What is a record?
Checked against GilbApp d529620.
A record is one piece of data with its own address, such as a person, a place, a thing or a note.
Deeper
Also asked:
What is a node, as in Name this node… or Open in Nodes? A node is a record: one person, place, thing or note in your vault. Name this node… is the empty Name box where you type the record's name. The list of records is Records in Main menu.
What is an attribute? GilbVeda's word for the name of a field: one named fact on a record, such as its title or a due date. In Ontology such a term is marked ATTRIBUTE.
A record has a type and fields. A record's type says what kind of thing a record is, such as a note, a task or a person, taken from GilbVeda, the shared list of terms. A field is one named fact on a record, such as its title or a due date; its name comes from GilbVeda. Because every app takes these names from the same list, each app reads a record the same way. Example: the note Garden plan has the fields TITLE and BODY.
Every record lives in exactly one vault; a vault is the place where a person or a group keeps their records. In GilbApp you choose that vault under CREATE IN when you make the record; the answer on creating a record shows how. The answer on what GilbPlatform, GilbApp and a vault are says more about vaults. An AI vault holds only one record, a card for the AI itself; the answer on what an AI vault is says why.
A record's address is its vault's address followed by /e/ and a code of letters and digits, such as https://example-name.gilb.com/vault/e/ and that code. The code says nothing about the record: not what it is, who made it or when. GilbApp shows the address in the record's details under ADDRESS; the answer on copying a record's address shows how to copy it.
Records are joined by relations. A relation is a named link between two records, such as part-of or connected-to, that says how they are related. GilbPlatform gives each link an address of its own, as it does a record. It keeps no table for each kind of thing, the way a spreadsheet keeps one sheet of rows and columns for each: each record carries only the fields it has, and the links between records make a graph, a web of records and lines. Underneath, GilbPlatform stores all of it in PostgreSQL, a widely used database program; apps read and write records through GilbPlatform, not in that database. The answer on seeing how records are connected (the graph) shows the links.
GilbPlatform never writes over a fact: a change closes the old fact and adds the new one. Deleting ends a record; it does not erase it. The answer on seeing a record as it was before shows its history, and the answer on deleting a record and getting it back says more about deleting.
A file you put in a vault gets a record too, which describes it; the answer on attaching a file to a record shows how. Jackfruit, the vault agent, also finds, reads, writes and links records in your vaults when you ask it; the answer on working with Jackfruit shows how.
This answer is written for a computer screen.
Source: GilbVeda t:VaultRecord a:does ("One unit of data held in a Vault, with its own address, that a reader can open to learn what it states.", Suggested), read by public read https://veda.gilb.com/base/terms?q=Vault%20Record 2026-11-10 (the mint kit is signed out; made); NOT t:Record (the Planguage benchmark Record). Dev.Guide.Overview.Records ("A record is one thing in a vault: a catch, a note, a file's description. A record has an id, a type, and facts (named values). Every record lives in exactly one named vault."), .History ("The platform never overwrites a fact … A delete ends a record; it does not erase it."), .Vocabulary; Dev.Guide.Addresses.Record (`https://<name>.gilb.com/vault/e/<id>` for a /vault vault), .Ids ("Treat a record id as an opaque string. Do not read meaning, time or order from it"); all Standards read 2026-11-10. GilbPlatform 4d008a55 docs/BASE-DEVELOPER-GUIDE.md §1 :2219-2223 (One stored primitive … There is no per-type table, a relation is just an entity at /base/r/<id>), :2226-2229 (PostgreSQL 18 the primary substrate), §7.1 :7201-7225 (the five tables; documents computed on read), §7.2 :7227-7240 (id 12 opaque CSPRNG chars … reveals neither who minted it nor when); code read at 4d008a55. GilbApp af0f04ee src/components/records/RecordTagsSection.tsx:29 (uppercase label), :209-221 (Address with the record's address and a copy button).