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

# Custom objects

> Create custom record types to model business-specific entities.

**Custom objects** let you model entities not covered by Arya standard objects. Examples: `Legal case`, `Asset`, `Policy`, `Supplier`, `Property`, `Machinery`.

## When to create one

<AccordionGroup>
  <Accordion title="You have a recurring entity not covered">
    If you track "Legal cases" with hearing date, judge, role, opposing party — no standard object fits. Create a custom object.
  </Accordion>

  <Accordion title="Complex relationships">
    E.g. `Contract` linked to `Customer` + `Project` + `Responsible employee` with custom fields. Dedicated object keeps explicit relationships.
  </Accordion>

  <Accordion title="Specific automations">
    You want workflows on entity events (e.g. "case moves to In court"). Only objects (standard or custom) trigger workflows.
  </Accordion>
</AccordionGroup>

<Note>
  Before creating custom: check if a standard object + custom attributes suffices. E.g. `Supplier` often is just `Company` with type = Supplier.
</Note>

## Create a custom object

<Steps>
  <Step title="Settings → Objects → + New object">Admin-only.</Step>

  <Step title="Define">
    * Singular **name** (e.g. `Legal case`) and plural (`Legal cases`)
    * **Icon** (Lucide / Font Awesome)
    * **Description**
    * **URL slug** (for API, e.g. `legal-cases`)
  </Step>

  <Step title="Attributes">
    Add fields: name, date, select, reference to other records. See [Attributes](/en/arya-101/lesson-3-attributes).
  </Step>

  <Step title="Default views">
    Which columns, which filters, Kanban view (if has status) or table.
  </Step>

  <Step title="Permissions">
    Who can create, read, edit, delete records of this type.
  </Step>

  <Step title="Save">
    Object appears in sidebar. You can immediately create the first record.
  </Step>
</Steps>

## Included features

Every custom object automatically has:

<CardGroup cols={2}>
  <Card title="Multiple views">Kanban, table, calendar, Gantt (if has dates).</Card>
  <Card title="Filters and lists">Static and dynamic as for standard objects.</Card>
  <Card title="Automations">Triggers and actions as for standard objects.</Card>
  <Card title="AI">AryaChat sees the object and can answer questions.</Card>
  <Card title="Import/export">CSV, Excel.</Card>
  <Card title="API">Programmatic access via REST and webhooks.</Card>
</CardGroup>

## Relationships with other objects

Add a **Reference** attribute to link the custom object to others:

* `Legal case → Customer (Company)`: every case has a customer
* `Legal case → Lawyer (Employee)`: who handles it
* `Customer → Legal cases (reverse lookup)`: on the customer see all their cases

## Later modifications

You can always add/remove attributes. **Caution**:

* Renaming an attribute is safe
* Deleting an attribute with existing data requires confirmation (Admin)
* Deleting an attribute removes it **right away** everywhere: create/edit forms and the object table (no leftover fields)
* Changing attribute type (e.g. from Text to Number) fails if existing data isn't convertible

## Object deletion

<Warning>
  Deleting a custom object deletes all its records. Irreversible. Arya requires double confirmation and automatic backup export.
</Warning>

## Limits

* Max 50 custom objects per workspace
* Max 100 attributes per object
* Max 10 reference nesting levels (to avoid loops)

Extendable on Enterprise plans.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can I share custom objects across workspaces?">Yes, export as JSON → import. Structure definition is replicated; data isn't.</Accordion>
  <Accordion title="Do custom objects appear in reports?">Yes. Chart builder sees them as any object.</Accordion>
  <Accordion title="Are there ready-made custom object templates?">Yes, template library in **Settings → Objects → Templates** — covers legal, real estate, maintenance, healthcare sectors.</Accordion>
</AccordionGroup>