Record types
What record types are, how owners add types and fields and publish them, and how to approve record types your AI proposes.
A record type describes one kind of record, such as Customer, Project or Person, and the fields each record has. Records of the same type line up, so your AI can answer questions like "Which projects are due in May?" The standard type is the Note, with a label and a Details field. It is created when an owner sets up AI writing.
Record types are owner settings. Most knowledge bases need only a few.
Where to find them
Open Settings, then Data structure, then the Types tab. Choose a type to see its fields and its state.
Add a record type
- Choose New.
- Set Kind to Record type, and give it a Name, such as Customer.
- Enter a Key, such as customer. It's how AI tools and records refer to the type: lowercase letters, digits and underscores. It can never be changed later.
- Choose an Area. General suits most types.
- Choose Create.
Add fields
While editing a type, use Add fields. For each field, give a Name and choose its Kind: Text, Number, Yes or no, Date, Date and time, Choice, or Link to a record (for example, a Contact's Company). Tick Required if every record must have it. For a Choice, list the choices one per line. Then choose the Add button below the fields.
Each field's key comes from its name. You can change the key before adding the field, but not afterwards. You can add more choices to an existing Choice field later.
To change a type you've already published, choose Edit, make your changes, choose Save, then publish.
Publish
Nothing changes for AI tools or records until you choose Publish. Baffin checks the change first and shows what it will do. Check without publishing runs the same check without making the change live.
Each type shows its state:
- Live: in use.
- Unpublished changes: edited, but AI tools and records still use the live version.
- Not published yet: new, and nothing can use it until you publish.
- Archived: AI tools and new records can't use it. Choose Restore to bring it back.
Discard throws away unpublished changes. Under Technical details: keys, history, raw settings and archive you can archive a type, or pick an earlier version and choose Restore this version, then publish it.
Let your AI propose record types
Your AI can suggest a new type when you ask, for example "Set up a type for our suppliers." First, turn this on:
- Open Settings, then AI permissions.
- Under New kinds of records, choose I approve each one or Add them automatically.
- Choose Save.
Only owners' own AI connections can propose. With I approve each one, proposals appear at the top of Review, under Proposed record types. Each shows the fields, the instructions for AI tools, and what approving changes. Approve makes the type available to AI tools right away and updates your AI instructions. Reject asks why, and the AI sees your reason.
An AI can also propose adding fields or choices to an existing type. Those proposals only widen the type, so every existing record stays valid.
Add them automatically
With Add them automatically, new types, new fields and choices, and looser limits go live as soon as your AI asks. New instructions for AI tools and renames still wait for you in Review, as a change marked Follows an automatic change. Decided proposals show Applied automatically with what went live.
Each automatic change closes every AI tool's open write session, not only the proposing one's, so each tool starts a new session to save records (save_to_knowledge does this by itself).
AI connections that can't see every area, and knowledge bases with an inactive area, always wait for your approval, exactly as with I approve each one. When something needs you first (for example, your AI instructions have an unsaved draft), the proposal also waits in Review, and Review says why it couldn't apply automatically.
Browse records
Open Library, then Records, and pick a type in the sidebar to see its records in a table. Sort by Name or Updated, and choose a record to see its details beside the list. Every record has its own link, so you can share it or come back to it.