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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.