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

> Use admin-created custom objects to model business-specific entities.

**Custom objects** are record types created by workspace Admins to model entities specific to your business (e.g. `Legal case`, `Asset`, `Policy`). For configuring see [Custom objects settings](/en/settings/custom-objects); this page is for daily use.

## Where to find them

<Frame>
  <img src="https://mintcdn.com/agevole/MhzHKcOFoodziHoq/images/trasversali/en/custom-object-sidebar.svg?fit=max&auto=format&n=MhzHKcOFoodziHoq&q=85&s=e5e0ed7a73890622b450215f0351e374" alt="Sidebar with standard and custom objects" width="1200" height="720" data-path="images/trasversali/en/custom-object-sidebar.svg" />
</Frame>

Custom objects appear in sidebar like any standard object, with Admin-chosen icon and name.

## How to use them

Work exactly like standard objects (CRM, Tasks, etc.):

<CardGroup cols={2}>
  <Card title="Create record">+ New, fill defined fields.</Card>
  <Card title="Lists">Static and dynamic with filters.</Card>
  <Card title="Views">Table, Kanban (if has status), calendar.</Card>
  <Card title="Timeline">Activity, comments, attachments per record.</Card>
  <Card title="Relationships">Link to company, contacts, deals, other customs.</Card>
  <Card title="Automations">Triggers and actions on these records.</Card>
</CardGroup>

## Practical examples

<AccordionGroup>
  <Accordion title="Law firm — 'Case' object">
    Fields: case number, type (civil/criminal/administrative), party, opposing party, judge, hearing date, status (in investigation/in court/decided), fee.
    Relationships: Customer (Company), Responsible lawyer (Employee).
  </Accordion>

  <Accordion title="Real estate — 'Property' object">
    Fields: address, type, sqm, rooms, asking price, status (available/reserved/sold), photos, floor plan.
    Relationships: Owner (Contact), Agent (Employee), Visits (sub-object).
  </Accordion>

  <Accordion title="Maintenance — 'Machinery' object">
    Fields: serial number, brand, model, installation date, next maintenance, status (operational/in maintenance/out of service).
    Relationships: Customer (Company), Interventions (sub-object).
  </Accordion>

  <Accordion title="Insurance — 'Policy' object">
    Fields: policy number, type (auto/life/damage), annual premium, expiry date, auto-renewal, beneficiaries.
    Relationships: Holder (Contact), Claims (sub-object).
  </Accordion>

  <Accordion title="Healthcare — 'Patient' object">
    Fields: personal data, conditions, allergies, treating physician, last visit date.
    Relationships: Doctor (Employee), Visits (sub-object), Prescriptions (sub-object).
    Privacy: restricted access, full audit log.
  </Accordion>
</AccordionGroup>

## Workflows and automations

Like standard objects, customs trigger workflows:

* *"When a Case moves to 'In Court' → notify lawyer + create preparation task"*
* *"When a Property is Sold → generate agent commission invoice"*
* *"Every day → find Machinery with next maintenance \< 30 days → notify technician"*
* *"When a Policy is expiring \< 60 days → email customer for renewal"*

## Contextual AI

AryaChat sees custom objects and can respond:

* *"How many civil cases do I have open?"*
* *"Show properties available above 300k"*
* *"Which policies expire this quarter?"*
* *"Summarise maintenance done on this machinery"*

## Reports and dashboards

Custom objects are available in chart builder, as any standard object. You can build specific dashboards:

* Cases by status
* Properties by area and average price
* Scheduled maintenance
* Policy revenue by type

## Permissions

As for standard objects, Admin manages custom permissions:

* Who can see records
* Who can create/edit them
* Sensitive fields hidden from certain roles

Check with Admin if expected objects are missing.

## Import / export

* **Import**: from CSV/Excel. Admin can load initial data.
* **Export**: you can always export, respects permissions.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can I ask Admin to create an object for me?">Yes. Explain use case and admin can evaluate. Avoid unnecessary customs — often standard object + attributes suffices.</Accordion>
  <Accordion title="Do custom objects slow Arya?">No, designed for identical performance to standards.</Accordion>
  <Accordion title="What if Admin deletes a custom object?">Alert to all users. Existing data is auto-exported. Irreversible once deleted.</Accordion>
</AccordionGroup>