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

# Custom Fields

> Add fields to objects to capture additional data

## Overview

Custom fields let you add properties to any object (core or custom) to capture business-specific data.

***

## Field Types

| Type             | Use for                         |
| ---------------- | ------------------------------- |
| **String**       | Short text (names, IDs)         |
| **Text**         | Long text (notes, descriptions) |
| **Number**       | Numeric values                  |
| **Currency**     | Monetary amounts                |
| **Percentage**   | Percentage values               |
| **Boolean**      | Yes/No flags                    |
| **Date**         | Dates                           |
| **Timestamp**    | Date and time                   |
| **Email**        | Email addresses                 |
| **Phone**        | Phone numbers                   |
| **URL**          | Web links                       |
| **Select**       | Single choice from a list       |
| **Multi-Select** | Multiple choices from a list    |
| **JSON**         | Structured data                 |
| **Object**       | Reference to another object     |

***

## Adding a Custom Field

<Steps>
  <Step title="Select Object">
    Go to **Settings** → **Objects** → Select the object
  </Step>

  <Step title="Add Field">
    In the **Attributes** tab, click **Add Field**
  </Step>

  <Step title="Configure Field">
    Fill in the field details:

    * **Label** - Display name
    * **Type** - Select from available types
    * **Description** - Help text for users
    * **Category** - Group related fields
  </Step>

  <Step title="Set Options">
    Configure additional options:

    * **Required** - Must have a value
    * **Filterable** - Can filter by this field
    * **Read-only** - Cannot be edited after creation

    For Select/Multi-Select fields, define the allowed values.
  </Step>
</Steps>

***

## AI-Powered Fields

When adding a customer field, the modal offers **Standard** or **AI-powered**. AI-powered fields are computed by AI from each customer's data on a schedule — see [AI fields](/product/ai-fields).

***

## Editing Fields

Click any field to edit its properties. You can change:

* Label and description
* Category
* Required/filterable/read-only settings
* Allowed values (for select fields)

<Note>
  Field type and API name cannot be changed after creation.
</Note>

***

## Archiving Fields

To archive a field you no longer need:

1. Click the field
2. Select **Archive**
3. Provide a reason

Archived fields are hidden but data is retained.