> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getkato.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Choose what to track

> Use objects to give related records a shared structure.

export const DocImage = ({src, alt, caption, kind = "workspace", thumbnail = false, natural = false}) => {
  const paths = {
    objects: "m12 3 9 4.5v9L12 21l-9-4.5v-9L12 3Z M3 7.5l9 4.5 9-4.5 M12 12v9",
    attributes: "M4 5h16 M4 12h16 M4 19h16 M8 3v4 M16 10v4 M10 17v4",
    records: "M5 3h14v18H5z M8 7h8 M8 11h8 M8 15h5",
    relationships: "M8 8H4v8h4 M16 8h4v8h-4 M8 12h8 M10 10l-2 2 2 2 M14 10l2 2-2 2",
    views: "M3 4h18v16H3z M3 9h18 M9 9v11 M15 9v11",
    importing: "M12 3v12 M8 11l4 4 4-4 M4 16v5h16v-5",
    workspace: "M4 4h16v16H4z M4 9h16 M9 9v11",
    navigation: "m5 5 14 5-6 3-3 6-5-14Z",
    team: "M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2 M16 4a4 4 0 0 1 0 8 M22 21v-2a4 4 0 0 0-3-3.87 M13 7a4 4 0 1 1-8 0 4 4 0 0 1 8 0Z",
    tasks: "M9 6h11 M9 12h11 M9 18h11 M3 6l1 1 2-2 M3 12l1 1 2-2 M3 18l1 1 2-2",
    meetings: "M4 5h16v15H4z M4 10h16 M8 3v4 M16 3v4 M8 14h3 M8 17h6",
    ai: "m12 3 2.5 6.5L21 12l-6.5 2.5L12 21l-2.5-6.5L3 12l6.5-2.5L12 3Z",
    automation: "M9 3h6v6H9z M3 16h6v5H3z M15 16h6v5h-6z M12 9v4 M6 16v-3h12v3"
  };
  return <figure className={["kato-visual", thumbnail ? "kato-visual--thumbnail" : ""].filter(Boolean).join(" ")}>
    {src ? <div className={["kato-visual-frame", natural ? "kato-visual-frame--natural" : ""].filter(Boolean).join(" ")}>
        {thumbnail ? <img src={src} alt={alt || ""} loading="lazy" decoding="async" /> : <a className="kato-visual-fullsize" href={src} target="_blank" rel="noreferrer" aria-label={`Open full-size image: ${alt || caption || "Kato guide"}`}>
            <img src={src} alt={alt || ""} loading="lazy" decoding="async" />
          </a>}
      </div> : <div className="kato-visual-frame kato-placeholder" role={thumbnail ? undefined : "img"} aria-label={thumbnail ? undefined : `Image placeholder: ${alt || caption || "Kato workspace"}`} aria-hidden={thumbnail ? "true" : undefined}>
        <span className="kato-orbit kato-orbit--outer" />
        <span className="kato-orbit kato-orbit--inner" />
        <span className="kato-visual-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.4" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true"><path d={paths[kind] || paths.workspace} /></svg></span>
        {!thumbnail && <span className="kato-placeholder-label">Image placeholder</span>}
      </div>}
    {caption && !thumbnail && <figcaption>{caption}{src && <span className="kato-visual-hint">Select the image to view it full size.</span>}</figcaption>}
  </figure>;
};

An object describes a kind of thing your team tracks. Clients, projects, and
people are examples. Each object has its own attributes and a collection of
records that use those attributes.

<DocImage kind="objects" alt="An object and its collection of records" caption="One structure for the things that belong together." />

## Open an object

Find your workspace's objects in the **Objects** section of the sidebar. The
names depend on how your workspace is configured. Open one to browse its records
and the available views.

## Decide whether you need a new object

Create an object when you need a separate collection with its own details and
connections. A team that manages properties, for example, might need a Properties
object with an address and links to the people responsible for each property.

If you only need another detail about an existing item, add an attribute instead.
If you need to focus on a subset of the same items, create a view.

| You want to…                              | Consider…                  |
| ----------------------------------------- | -------------------------- |
| Track properties alongside clients        | A Properties object        |
| Store a client’s preferred contact method | An attribute on Clients    |
| See only active client records            | A filtered view of Clients |

## Sketch the object before creating it

Write down three real examples of what the object will contain. For Projects,
these might be **Relio website**, **Relio onboarding**, and **Harbor
brand refresh**. Then identify the information that all three need.

| Detail                | Where it belongs             | Reason                                                  |
| --------------------- | ---------------------------- | ------------------------------------------------------- |
| Project name          | A name attribute on Projects | Every project needs a recognizable label.               |
| Target date           | A date attribute on Projects | Each project can have a different deadline.             |
| Client                | A relationship to Clients    | Several projects may share the same client.             |
| “Needs review” subset | A view of Projects           | It is a way to select projects, not a new kind of item. |
| Send a brief          | A task linked to the project | It is an action with a completion point.                |

If your examples need unrelated sets of attributes, you may be combining two
kinds of thing. If two proposed objects need the same details and differ only
by status, one object with separate views may be easier to maintain.

## Create and check the structure

When you have access to object configuration, open the object creation form.
Fill in its name and singular/plural labels, add a short description, and choose
an icon. After creation, review its **Attributes** settings and add the custom
details you need. Existing system attributes may already cover some details.

Create one sample record before adding all your data. Check whether its form
asks for the right information and whether another teammate can understand the
record without an explanation from you.

If you cannot find the configuration controls, ask your workspace administrator
to review the object with you. Do not create a substitute object solely to work
around an access problem.

## Name it for your team

The object creation form includes a name, singular and plural labels, an icon,
and a description. Use names your teammates recognize: **Property** for one record,
**Properties** for the collection. A short description can explain what belongs here.

Before expanding the structure, add a few representative records. Check that the
attributes capture the information you need without making everyday entry cumbersome.

<Card title="Design useful attributes" icon="sliders" href="/documentation/data/attributes">
  Choose the details each record should hold.
</Card>


## Related topics

- [How your data fits together](/documentation/data/how-data-connects.md)
- [WhatConverts](/integrations/whatconverts.md)
- [WhatsApp](/integrations/whatsapp.md)
- [Timely](/integrations/timely.md)
- [Railway](/integrations/railway.md)
