How the system is built
Why your CRM needs an ontology
Every firm already has one - the vocabulary of what a client is, what a meeting is, what "signed off" means. In most software it lives in people's heads and in a database nobody can read. Writing it down once, and making the software obey it, changes what the software can promise you.
Published September 2026 · By the UltimateCRM team
What an ontology is, in plain terms
The word comes from philosophy and has been made fashionable by defense and enterprise software, but the idea is simple. An ontology is a written list of the kinds of things a business deals with, the relationships between them, and the actions that can happen to them - kept in one place, in the software's own language, so that every screen, report, and integration reads from the same list instead of keeping its own.
For an advisory firm the kinds of things are contacts, households, notes, tasks, documents, emails, meetings, calls, texts, insurance policies, estate documents, KYC reviews, obligations, attestations, and so on. The relationships are the ones you already know: a contact belongs to a household; a note is anchored to a contact or a household; a document is filed under one. The actions are the verbs: a note was finalized, a review was signed off, a rollover record was completed, a recording was downloaded, an obligation was waived.
A database has all of this too - but as tables and columns, with the meaning implied by code scattered across the application. The difference with an ontology is that the meaning is declared, once, and the rest of the software is held to it.
Where the meaning usually lives instead
Most CRMs grow by accretion. A feature adds a screen, the screen invents a label, a report invents another, and a mobile app invents a third. Nothing is wrong on any given day. But over a few years the same fact gets four names, a client's timeline fills with half-labelled events ("Meeting" - which kind? "Document" - uploaded or deleted?), search covers whatever the search feature happened to be told about, and the compliance export lists whatever the export happened to be told about. When an examiner asks "what does your system record?", the honest answer is a grep through the source code.
That drift is not a bug in any one feature. It is what happens when the vocabulary has no home.
What we did about it
UltimateCRM keeps its ontology in two declared tables that the running software is built from and tested against.
- The record registry. Every kind of record the system holds is declared once with its name, what it can be linked to, whether it is searchable, which page opens it, and how it rolls up (a contact's activity includes their household's, because the registry says so). Search, the ⌘K palette, the note and file pickers, the feed, and the iPad all read that one declaration. As of September 2026 it names 45 kinds of record.
- The action catalog. Every action the system records is declared once - 140 of them today - with who performs it (staff, an admin, the client, or the system itself), what it writes to the audit log, to a client's timeline, and to the append-only compliance log, and the retention clock on the compliance entry. There is exactly one way for the software to record anything, and it takes its names from the catalog. A new kind of event cannot reach a release undeclared: our test suite refuses it.
Why an advisor should care
- Search finds every kind of thing. Contacts, households, notes, tasks, organizations, documents, emails, meetings, calls, and texts are all searchable because the registry says they are - and a kind of record we add later joins search the day it exists, not when someone remembers.
- A client's timeline reads like a story. Every event on it carries a proper label from the catalog - "Obligation completed", "Rollover analysis signed off", "Meeting booked" - the same label on the web and on the iPad. No mystery entries.
- You can answer the examiner's first question. "What does your system record, and for how long?" is a table in the Compliance workspace and a file in the exam packet, generated from the catalog rather than written by hand. It lists every recorded action, who acts, which logs it writes to, and the retention clock - five years for most compliance entries, seven for rollover records, and for register documents the document's own class. It is the answer examiners want first.
- Access is a record too. Viewing an archived email, opening a call recording, downloading a client's file - each is a declared action with an "access" mark, so "who looked at what" is part of the trail rather than an afterthought.
- The product can grow without drifting. Because the vocabulary has one home and the tests hold the software to it, a new feature cannot quietly invent a fourth name for a meeting or a second way to write an audit entry. What you learn about the system stays true.
- Your devices agree with each other. The web app and the iPad app are generated from the same declarations. A record kind or an event label is not something each app maintains on its own.
What it is not
An ontology is not a taxonomy the firm has to maintain. You do not edit it, and you do not have to think about it; tags remain free-form for the things that are yours to name. The ontology is the part of the vocabulary that has to be exact - what the software itself records and promises - and keeping that exact is our job, not yours.
It is also not a rename of your history. The strings stored in years of audit and compliance entries never change; the catalog documents what each one means, including the ones we would name differently today. A compliance record that says one thing on the day it was written says the same thing forever.
Why it matters more as the platform grows
The declared vocabulary is also a contract. When two systems share it - a CRM and a market-intelligence tool, or a planning engine and an investment-committee workflow - a household, a document, or a strategy can be referred to by one name across all of them, and an action taken in one can be recognized, labelled, and filed by the others. That is the foundation for connecting systems without the meaning drifting between them, and for any future assistant that needs to know, precisely, what kinds of things exist and what may be done to them. We built the ontology first so that everything added to the platform declares itself in the same terms.
The short version
A CRM without an ontology knows a great deal but can explain very little of it. With one, the software can say exactly what it holds and exactly what it records - to you, to your devices, and to an examiner - and it stays able to say so as it grows. For a firm whose business is trust, that is not an architectural nicety. It is the difference between a system you use and a system you can vouch for.
See what the system records
Open the Compliance workspace and read the full list of recorded events - every action, who acts, and how long it is kept.