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

# AI Fields

> AI fields can summarize text, classify tags, generate scores, or turn content into images.

<Note>Available on all Cloud plans. Self-hosted deployments require the Business plan or higher.</Note>

## Main Use Cases

AI fields generate the current field value from other fields in the same row. Use them to turn raw content into summaries, translations, extracted details, categories, scores, dates, or images.

<Columns cols={2}>
  <Card title="Text" icon="text">
    Summarize, translate, extract information, improve writing, or customize the output. Best for turning longer text into usable copy.
  </Card>

  <Card title="Single select" icon="circle-dot">
    Smart classify or customize the output. Best for matching content to one existing category.
  </Card>

  <Card title="Multiple select" icon="tags">
    Smart tag or customize the output. Best for matching content to one or more existing tags.
  </Card>

  <Card title="Rating / Number" icon="star">
    Rate or customize the output. Best for generating scores or numeric results from source content.
  </Card>

  <Card title="Date" icon="calendar">
    Extract information or customize the output. Best for extracting dates or times from content.
  </Card>

  <Card title="Attachment" icon="image">
    Generate images or customize the output. Best for creating images from text or attachments.
  </Card>
</Columns>

If you are not sure which action to use, start here:

<AccordionGroup>
  <Accordion title="Summarize, Translate, Extract Information">
    * **Summarize**: Creates a summary from the source field.
    * **Translate**: Translates the source field into the target language.
    * **Extract Information**: Extracts specific information from text. Date fields can also use it to extract dates or times.
  </Accordion>

  <Accordion title="Improve Writing, Smart Classify, Smart Tag">
    * **Improve Writing**: Rewrites content based on your additional requirements.
    * **Smart Classify**: Matches a single select field to an existing option.
    * **Smart Tag**: Matches a multiple select field to existing options.
  </Accordion>

  <Accordion title="Rate, Generate Image">
    * **Rate**: Generates a score or numeric value from the source content.
    * **Generate Image**: Creates images in an attachment field. Some models support using an attachment field as a reference image.
  </Accordion>

  <Accordion title="Customize">
    Use a custom prompt when the default actions do not cover your case. Custom prompts can reference fields from the same row.
  </Accordion>
</AccordionGroup>

## Workflow

<Steps>
  <Step title="Add a field">
    Create a field, choose the field type, then expand **AI Configuration**. Each field type shows the AI actions it supports.
  </Step>

  <Step title="Choose an action and model">
    Choose the **AI Action Type** and **AI Model**. The action controls the task. The model controls which AI model generates the result.
  </Step>

  <Step title="Choose source fields">
    Choose the field AI should read as input. The AI field generates its value from source fields in the same row.
  </Step>

  <Step title="Add generation requirements">
    Depending on the action, fill in **Additional Requirements**, **Target Language**, or a **Custom Prompt**. For image generation in attachment fields, use **Advanced Settings** to adjust image size, quality, count, aspect ratio, resolution, or reference images. Available settings depend on the selected model.
  </Step>
</Steps>

<img src="https://mintcdn.com/teablecn/TO9j-Q8_3sjEReNV/images/docs/base/2026-05-22-ai-field-create-config.png?fit=max&auto=format&n=TO9j-Q8_3sjEReNV&q=85&s=2b31cccc55c714dc7830b46b044744a3" alt="Create an AI field" className="docs-screenshot" width="1600" height="1095" data-path="images/docs/base/2026-05-22-ai-field-create-config.png" />

When you edit an AI field, you can change the action type, model, source fields, additional requirements, custom prompt, and auto-update setting. After you save, the new configuration applies to future generations. If an existing result is not what you want, regenerate it.

<img src="https://mintcdn.com/teablecn/TO9j-Q8_3sjEReNV/images/docs/base/2026-05-22-ai-field-edit-config.png?fit=max&auto=format&n=TO9j-Q8_3sjEReNV&q=85&s=a99c8488f6e9758ef124a466d7ff19f2" alt="Edit an AI field" className="docs-screenshot" width="1600" height="1100" data-path="images/docs/base/2026-05-22-ai-field-edit-config.png" />

## Auto-update and Batch Generation

When **Auto-update** is enabled, the AI field updates with the current configuration when source field content or the AI configuration changes. Use it when the result should stay in sync with source content, such as categories, summaries, scores, or tags generated from feedback.

After you create a field or change its AI configuration, you can choose whether to process records in the current view right away:

<Columns cols={3}>
  <Card title="Fill empty cells only" icon="circle">
    Generate content only for empty cells. Existing values are not overwritten.
  </Card>

  <Card title="Generate entire column" icon="rotate">
    Regenerate results for records in the current view. Existing values are overwritten.
  </Card>

  <Card title="Save configuration only" icon="floppy-disk">
    Save the field configuration without writing values to cells.
  </Card>
</Columns>

<img src="https://mintcdn.com/teablecn/TO9j-Q8_3sjEReNV/images/docs/base/2026-05-22-ai-field-save-options.png?fit=max&auto=format&n=TO9j-Q8_3sjEReNV&q=85&s=de791ff173535586627d012371c6523e" alt="AI field save options" className="docs-screenshot" width="1600" height="998" data-path="images/docs/base/2026-05-22-ai-field-save-options.png" />

After you choose a generation option, Teable shows the task status while it processes records.

<img src="https://mintcdn.com/teablecn/TO9j-Q8_3sjEReNV/images/docs/base/2026-05-22-ai-field-generation-status.png?fit=max&auto=format&n=TO9j-Q8_3sjEReNV&q=85&s=0492c4a7e2080dea562f7d0782731ea1" alt="AI field generation status" className="docs-screenshot" width="1600" height="760" data-path="images/docs/base/2026-05-22-ai-field-generation-status.png" />

To run generation later, use the field menu instead of saving the configuration again.

You can also right-click the field and choose **Generate** to run batch generation for the current view. Availability depends on the current view and your permissions.

<img src="https://mintcdn.com/teablecn/TO9j-Q8_3sjEReNV/images/docs/base/2026-05-22-ai-field-generate-menu.png?fit=max&auto=format&n=TO9j-Q8_3sjEReNV&q=85&s=566378ec1e69e84f702e1df932d800ba" alt="AI field generate menu" className="docs-screenshot" width="1600" height="911" data-path="images/docs/base/2026-05-22-ai-field-generate-menu.png" />

## FAQ

<AccordionGroup>
  <Accordion title="Will AI fields automatically process existing records?">
    After you create a field or change its AI configuration, you can choose **Fill empty cells only**, **Generate entire column**, or **Save configuration only**. You can also batch generate later from the field right-click menu by choosing **Generate**.
  </Accordion>

  <Accordion title="When should I enable auto-update?">
    Enable **Auto-update** if you want the AI field to update when source field content changes. If you want to control when generation runs, leave it off and use **Generate** when needed.
  </Accordion>

  <Accordion title="Why do different field types show different AI actions?">
    AI actions depend on the field type. Text fields are suited for summarizing, translating, and extracting information. Single select fields are suited for Smart Classify. Multiple select fields are suited for Smart Tag. Attachment fields are suited for image generation.
  </Accordion>

  <Accordion title="Why don't I see the model I want to use?">
    The model list comes from models provided by Teable and AI models configured in the current space. To use a third-party model, add a custom AI model in space settings first.
  </Accordion>

  <Accordion title="Why do image generation options change?">
    Image size, quality, count, aspect ratio, resolution, and reference image options depend on the selected model.
  </Accordion>
</AccordionGroup>
