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

# Overview

> Objects define how your business data is structured, connected, and displayed.

# Objects

Objects are the foundation of data in Custral. They define how information is structured, connected, and displayed across your workspace. Every process in Custral (from sales to onboarding, support, and success) is powered by Objects.

Each Object represents a distinct type of entity in your business. For example, you might have Objects like **Companies**, **Contacts**, **Deals**, or **Tickets**.
Each entity contains multiple **Records**, which hold the actual data, such as “Acme Corp” or “Renewal - Q4”.

***

## Overview

Objects define what kind of data you track and how that data connects to other parts of your business.

| Object      | Represents                          | Example Record           |
| ----------- | ----------------------------------- | ------------------------ |
| **Company** | An organization or customer account | Acme Corp                |
| **Contact** | A person or user tied to a company  | Sarah Johnson            |
| **Deal**    | A revenue opportunity or project    | Renewal - Acme Corp (Q4) |
| **Ticket**  | A support or success issue          | Billing error on renewal |

Every Object includes:

* **Properties** that describe the fields of data stored on each Record
* **Records** that represent individual instances of that Object
* **Views** the visual representation of a record

<Tip>
  When creating a new Object you can start from a **preset**, a curated starter kit (such as **Customer** or **Project Tracker**) that seeds the Object with sensible default properties and views, or start blank. Some Objects (like **Tasks**) are **system Objects** that Custral provisions for you and that can't be deleted or renamed.
</Tip>

***

## Object structure

Each Object in Custral is built from three main layers: **Properties**, **Records**, and **Associations**.

### 1. Properties

Properties define the shape of your Object. They are the fields that describe what information is stored for each Record.
Each Object can include any number of Properties, and each Property has a defined type.

Common Property types include:

| Type                      | Description                     | Example                    |
| ------------------------- | ------------------------------- | -------------------------- |
| **Text**                  | Plain text value                | `Industry: Software`       |
| **Number**                | Integer or decimal              | `Employee Count: 250`      |
| **Date**                  | Stores a date or timestamp      | `Renewal Date: 2026-06-01` |
| **Select / Multi-select** | Predefined options              | `Stage: Qualified`         |
| **Status**                | A single-select lifecycle state | `Status: Active`           |
| **Relation**              | Links to another Object         | `Company → Contact`        |
| **User**                  | References a workspace member   | `Owner: Avery Durrant`     |
| **File / Image**          | Uploads or linked assets        | `Contract.pdf`             |

When you create a new Object, Custral seeds it with two starter Properties:

| Property  | Type  | Description                                                                  |
| --------- | ----- | ---------------------------------------------------------------------------- |
| **Name**  | Text  | The Object's title property. The value shown wherever a Record is referenced |
| **Notes** | Notes | A rich-text document attached to each Record                                 |

Each Record also has built-in metadata that isn't a configurable Property:

| Field         | Description                                                                   |
| ------------- | ----------------------------------------------------------------------------- |
| **Record ID** | A unique identifier for the Record, shown in its URL (always prefixed `rec_`) |
| **Created**   | When the Record was created                                                   |
| **Updated**   | When the Record was last updated                                              |

## Example

A **Company** Object might define properties like **Name**, **Industry**, **Renewal Date**, **ARR**, and **Owner**. Every Company Record then carries a value for each of those properties:

| Property         | Type   | Example value |
| ---------------- | ------ | ------------- |
| **Name**         | Text   | Acme Corp     |
| **Industry**     | Text   | Software      |
| **Renewal Date** | Date   | 2026-06-01    |
| **ARR**          | Number | 120,000       |
| **Owner**        | User   | Avery Durrant |


## Related topics

- [Overview](/data/properties/common/overview.md)