Knowing how to create object types is one thing, but knowing when to create one is another. This guide walks you through a simple framework of three questions that will help you decide whether a new object type is the right call, or whether you can get by with what you already have.
Before creating a new object type, work through these questions in order:
If you answer "yes" to the first two and "no" to the third, a new object type is likely the right choice. But the answer is not always clear-cut. Let's look at two examples to see how the framework plays out in practice.
A common question is whether to have a single Person object type, or separate types for friends, family, and colleagues. Let's run through the three questions.
If you are already thinking about splitting people into friends, family, and colleagues, you likely see them as distinct groups. So yes, this passes the first check.
Consider the properties you would want for each group. Colleagues might need fields like organization, job title, and work email. Friends might benefit from a gift ideas property. Family members might need birthday or relationship fields.
These groups do have somewhat different properties, which could suggest separate object types. But before jumping to that conclusion, move on to question three.
In many cases, the answer is yes. Here's how:
A unified Person type also handles real-life overlap gracefully. When a colleague becomes a friend, or a friend joins your company, you don't need to move objects between types. Just update the category.
A single object type with categories, queries, and templates often covers what you need. You can always split it later if the groups truly diverge.
It's common to start with a general-purpose object type like Notes or Pages and use it for everything. Over time, you may notice certain patterns emerging: some notes are clearly about organizations, others about families, and others about projects.
If the groups share mostly the same properties and the only real difference is the topic, you likely don't need separate object types yet. Use collections or tags to organize them instead.
If you find yourself wanting properties that only apply to a subset of your notes, for example industry and company size for organizations, or family members as a linked property for families, it may be time to create dedicated object types.
When you do split, you can use the type conversion feature to move existing objects into their new types without losing content.
There is no single right answer, and your approach can evolve over time. Here's a quick decision guide:
| Question | Yes | No |
|---|---|---|
| Is it a distinct group? | Continue to question 2 | Stick with your current type |
| Does it have distinct properties? | Continue to question 3 | Use collections or tags instead |
| Can queries and visibility solve it? | Keep one type with categories and queries | Create a new object type |
Remember: you don't need to get it perfect from the start. Capacities is designed to let you restructure as your needs change. Start with fewer types and split them when you have a clear reason to.
Ask a question! - The Docs Assistant knows everything about the documentation, and the ideas and feature requests from other users.
Create a ticket on our feedback board. - Let us know if you have an idea for a feature, improvement or think there is something missing.
Request additions to the documentation. - If your questions are not getting answered, let us know and we will extend the documentation.