> ## 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.

# Work with records

> Keep the details of one client, project, or other item in one place.

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>;
};

A record is one item inside an object. If Projects is the object, **Relio
website** could be a record. Its attribute values describe that specific project.

<DocImage kind="records" alt="A Kato record with its attribute values and related information" caption="The details and context for one piece of your work." />

## Create a record

1. Open the object from the sidebar.
2. Choose **New** followed by the object's singular name, such as **New Project**.
3. Enter a recognizable name and the required details.
4. Add any useful links to other records.
5. Create the record and review its details.

Your form reflects the attributes configured for that object. Another workspace
may collect different information for the same kind of item.

## Keep details current

Open the record when you need to review or update its values. Use clear names
that help someone distinguish it from similar items. Update the status and other
working details when the work changes.

Before creating another record, check whether the item already exists. Reusing
one record keeps its relationships and context together.

## Example: add the Relio website project

Assume your Projects object has a name, a status, a target date, and a Client
relationship. Your workspace may use different labels.

| Attribute   | Example value              | Check before saving                         |
| ----------- | -------------------------- | ------------------------------------------- |
| Name        | Relio website              | Is there already a record for this project? |
| Status      | Planned                    | Is this the actual current stage?           |
| Target date | The date agreed at kickoff | Is it a commitment, or only an estimate?    |
| Client      | The existing Relio record  | Did you select the intended client?         |

Create the record and reopen it. Check the relationship by opening the linked
client. A client name typed into a text field may look similar, but it does not
provide the same connection.

## Make an update without losing context

When the project starts, change the status on this record. When its target date
changes, update that date rather than making another record for the revised plan.
Keep the name stable enough that your teammates can recognize the project.

Use the record to hold the current structured details, and the related work to
explain the actions around them. For example, the record holds the launch target;
a task describes the work needed to meet it.

## If the record seems to be missing

Check the workspace, object, selected view, and filters in that order. A project
that moved to Complete may disappear from an Active projects view even though
it still exists in the object. Confirm that you are looking for the same item
before recreating it.

If you can see the record but cannot edit a value, check whether it is a managed
attribute and whether you have the needed access. An unavailable field is not
necessarily an empty field.

## See the same record in different views

A record can appear in several views of its object. For example, a project might
appear in both an active-project table and a board grouped by status. These are
presentations of the same record, so a value changed in one is reflected in the other.

## Add the surrounding context

Link the record to the other items your team needs to understand it. A project
linked to its client is easier to interpret than a project with the client's name
copied into an unrelated text field.

<Card title="Connect related records" icon="link" href="/documentation/data/relationships">
  Build useful connections between the things you track.
</Card>


## Related topics

- [Design useful attributes](/documentation/data/attributes.md)
- [Sync client records](/recipes/sync-client-records.md)
- [Connect related records](/documentation/data/relationships.md)
- [Search the workspace](/api-reference/raycast/search.md)
- [Raycast](/integrations/raycast.md)
