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

# Field Configuration

> Choose how each action field should be filled: Auto, AI Prompt, or Set Manually.

<div style={{ display: 'flex', justifyContent: 'center', margin: '2rem 0' }}>
  <div className="video-card">
    <video src="https://mintcdn.com/lindyai/vTETa6Bb9Fi7xfg7/lindy-brand-assets/field_config.mp4?fit=max&auto=format&n=vTETa6Bb9Fi7xfg7&q=85&s=f83fb43cde988eb8de79a1868dcd51f3" width="600" autoPlay muted loop playsInline style={{ display: 'block', width: '100%', borderRadius: '16px' }} data-path="lindy-brand-assets/field_config.mp4" />
  </div>
</div>

## Quick Overview

When you add an action, you'll see fields to configure. Lindy gives you three ways to fill each field depending on how much control you want and how dynamic the value should be.

* **Auto**: Let your agent intelligently determine the best value based on all previous data
* **AI Prompt**: Give natural language instructions for dynamic content generation
* **Set Manually**: Enter exact values or reference specific data from previous steps

Each mode serves different purposes and choosing the right one makes your workflows more efficient and reliable.

<Frame>
  <img src="https://mintcdn.com/lindyai/vTETa6Bb9Fi7xfg7/lindy-brand-assets/field-all-3-modes.png?fit=max&auto=format&n=vTETa6Bb9Fi7xfg7&q=85&s=83df8ae4ec85490b1b339b744b110a65" alt="Three field configuration modes in Lindy - Auto, AI Prompt, and Set Manually" width="1156" height="888" data-path="lindy-brand-assets/field-all-3-modes.png" />
</Frame>

## Auto Mode

Auto mode is Lindy's intelligent field completion system. It analyzes all previous steps in your workflow and automatically determines the most appropriate value for each field.

### How It Works

When set to Auto, your agent:

1. Examines all data from previous triggers and actions
2. Matches field names with available data intelligently
3. Infers the best value based on context and field type

<Info>
  Lindy's Auto mode can pull from form submissions, API responses, search results, and other data from earlier steps. It's useful when the right value depends on context.
</Info>

### When to Use Auto Mode

Auto mode excels in scenarios where:

* **Data mapping is predictable**: Moving form data to spreadsheets
* **Field names align**: "Customer Name" automatically maps to "Name" column
* **Context is clear**: Updating CRM records with email data
* **You want flexibility**: Let Lindy adapt to varying data structures

### Example Use Case

```
Scenario: Responding to customer emails
Auto mode automatically:
- Sets "To" field → Original sender's email
- Keeps "From Name" → Your default sender name  
No configuration needed!
```

<Frame>
  <img src="https://mintcdn.com/lindyai/VHBHJwXMXFd-cbnu/lindy-brand-assets/auto_mode_image.png?fit=max&auto=format&n=VHBHJwXMXFd-cbnu&q=85&s=f0d1f807298d650125279f62924f7815" alt="Auto mode intelligently filling email fields based on previous workflow data" style={{ borderRadius: '8px', border: '1px solid #e5e7eb' }} width="2390" height="1564" data-path="lindy-brand-assets/auto_mode_image.png" />
</Frame>

The image above shows Auto mode in action - notice how the "To" field is set to Auto and displays "AI will automatically fill this field" based on context from previous steps.

## AI Prompt Mode

AI Prompt mode lets you give your agent natural language instructions to generate dynamic content. It'll create text based on your directions and all available workflow data.

<Frame>
  <img src="https://mintcdn.com/lindyai/VHBHJwXMXFd-cbnu/lindy-brand-assets/ai_prompt_mode_initial.png?fit=max&auto=format&n=VHBHJwXMXFd-cbnu&q=85&s=e9c102f3ebf9ef642f4ff8539a95de5b" alt="AI Prompt mode interface showing dropdown options" style={{ borderRadius: '8px', border: '1px solid #e5e7eb' }} width="788" height="1358" data-path="lindy-brand-assets/ai_prompt_mode_initial.png" />
</Frame>

### Writing Effective Prompts

The key to AI Prompt mode is clear, specific instructions:

<Frame>
  <img src="https://mintcdn.com/lindyai/aZLeG0KVxZc0yYx4/lindy-brand-assets/writing_effective-prompts.png?fit=max&auto=format&n=aZLeG0KVxZc0yYx4&q=85&s=b2e31cc676adf6e8755535f57939b1fa" alt="Writing effective prompts with good and bad examples" style={{ borderRadius: '8px', border: '1px solid #e5e7eb' }} width="774" height="570" data-path="lindy-brand-assets/writing_effective-prompts.png" />
</Frame>

```
✅ Good: "Write a friendly 2-line thank you mentioning the product name"
❌ Avoid: "Write something nice"
```

<Tip>
  To reference data from previous steps, click the dropdown button and select from available outputs. The video below shows how this works - no need to type brackets manually!
</Tip>

### When to Use AI Prompt Mode

Choose AI Prompt for:

* **Email composition**: Subject lines, body content, personalized messages
* **Content generation**: Summaries, descriptions, social posts
* **Data transformation**: Reformatting dates, combining fields creatively
* **Conditional text**: Different messages based on context

<p style={{ textAlign: 'center', fontSize: '0.9rem', color: '#666', marginTop: '0.5rem' }}>
  💡 Learn more about [writing effective prompts](/fundamentals/lindy-101/prompt-guide)
</p>

### Using References in AI Prompts

<div style={{ display: 'flex', justifyContent: 'center', margin: '2rem 0' }}>
  <div className="video-card">
    <video src="https://mintcdn.com/lindyai/C8FfeR01UMnuv-H3/lindy-brand-assets/dropdown_for_field_configuration_within_fields.mp4?fit=max&auto=format&n=C8FfeR01UMnuv-H3&q=85&s=7c28cb52012ff3009abc5c655703a9a5" width="600" autoPlay muted loop playsInline style={{ display: 'block', width: '100%', borderRadius: '16px' }} data-path="lindy-brand-assets/dropdown_for_field_configuration_within_fields.mp4" />
  </div>
</div>

<Tip>
  The dropdown shows all available data from previous steps. In AI Prompt mode, these references become part of your instructions to generate dynamic content.
</Tip>

### Advanced Example

<Frame>
  <img src="https://mintcdn.com/lindyai/QWdJNkViLsD1veyH/lindy-brand-assets/prompt_w_ai_and_reference_to_action_info_advanced.png?fit=max&auto=format&n=QWdJNkViLsD1veyH&q=85&s=c28ec4dd15055f0c3153e5736fdbe9fb" alt="Advanced AI Prompt example with references to previous action data" style={{ borderRadius: '8px', border: '1px solid #e5e7eb' }} width="2624" height="1842" data-path="lindy-brand-assets/prompt_w_ai_and_reference_to_action_info_advanced.png" />
</Frame>

In this example, the AI Prompt intelligently combines:

* **Reference to previous data**: `bodyAsText` pulls in the actual content from a previous step (like an email or document)
* **Contextual analysis**: Your agent reads and understands the referenced content to determine if the person is new or returning
* **Dynamic decision-making**: Based on what it finds in the data, it generates different personalized offers

This showcases the power of AI Prompt mode. Instead of rigid rules, your agent analyzes the actual context from previous steps to generate the most appropriate response. The reference acts as a variable that gets replaced with real data at runtime, which your agent then uses to make intelligent decisions.

## "Set Manually" Mode

Set Manually mode gives you complete control: what you type is exactly what appears. Perfect for fixed values and precise data references.

### Direct Value Entry

Two ways to use Set Manually:

1. **Fixed text**: Type exactly what should appear

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/lindyai/lindy-brand-assets/direct_value_entry_type%20exactly_what_appears.png" alt="Set Manually with fixed text - what you type is what appears" style={{ borderRadius: '8px', border: '1px solid #e5e7eb' }} />
</Frame>

2. **Data references**: Insert exact values from previous steps

<Frame>
  <img src="https://mintcdn.com/lindyai/C8FfeR01UMnuv-H3/lindy-brand-assets/direct_value_entry_data_ref.png?fit=max&auto=format&n=C8FfeR01UMnuv-H3&q=85&s=25c5e20834fc13282c0290389529439b" alt="Set Manually with data references - combining text with exact values from previous steps" style={{ borderRadius: '8px', border: '1px solid #e5e7eb' }} width="2514" height="1762" data-path="lindy-brand-assets/direct_value_entry_data_ref.png" />
</Frame>

<Note>
  Set Manually mode uses no AI processing = fewer credits consumed. It's the most efficient option for fixed values.
</Note>

### When to Use Set Manually

Perfect for:

* **Fixed values**: Email addresses, signatures, webhook URLs, API keys
* **Exact references**: Order IDs, customer names, timestamps
* **Skip fields**: Leave empty to skip a field entirely
* **Combined text**: Mix static text with data references

## Using Output References

The field configuration dropdown gives you instant access to data from previous steps: forms, API responses, search results, and more. This lets you connect information across your workflow without retyping it.

### Reference Behavior by Mode

References behave differently in each mode:

| Mode             | Reference Behavior    | Example                                    |
| ---------------- | --------------------- | ------------------------------------------ |
| **Auto**         | Considers all context | Lindy intelligently uses available data    |
| **AI Prompt**    | Part of instructions  | `Summarize [Search: Results]` → AI summary |
| **Set Manually** | Exact value insertion | `Order #[Form: ID]` → `Order #12345`       |

## Best Practices

<AccordionGroup>
  <Accordion title="Start with Auto Mode">
    When unsure, try Auto first. Your agent often correctly infers what you need, saving configuration time.
  </Accordion>

  <Accordion title="Be Specific in AI Prompts">
    Instead of "write an email", use "write a 3-paragraph follow-up email thanking them for \[Meeting: Topic] and proposing next steps"
  </Accordion>

  <Accordion title="Test with Real Data">
    Use the test panel to see how each mode handles your actual data before going live.
  </Accordion>

  <Accordion title="Combine Modes Strategically">
    Use Set Manually for email addresses, AI Prompt for subject/body, and Auto for updating your CRM.
  </Accordion>
</AccordionGroup>

## Common Pitfalls & Solutions

### Troubleshooting Guide

1. **Field shows as empty**
   * Check if Set Manually has content (empty = skip)
   * Verify referenced data exists in previous steps
   * Ensure Auto mode has clear context

2. **Wrong data appears**
   * Review your mode selection
   * Check reference syntax in Set Manually
   * Refine AI Prompt instructions

3. **Too many credits used**
   * Switch fixed values from AI Prompt to Set Manually
   * Use Auto instead of AI Prompt for simple mapping

4. **Inconsistent results**
   * Add examples to AI Prompts
   * Use Set Manually for values that shouldn't change
   * Ensure field names are clear for Auto mode

## Next Steps

Master these related concepts to build even more powerful workflows:

<CardGroup cols={2}>
  <Card title="Actions Overview" href="/fundamentals/lindy-101/actions" icon="arrow-pointer">
    Explore all available actions and their field requirements
  </Card>

  <Card title="Prompt Engineering" href="/fundamentals/lindy-101/prompt-guide" icon="pen-to-square">
    Write better AI prompts for dynamic content generation
  </Card>

  <Card title="Testing Workflows" href="/testing/test-panel" icon="play">
    Test your field configurations with real data
  </Card>

  <Card title="Knowledge Base" href="/fundamentals/lindy-101/knowledge-base" icon="database">
    Combine field references with knowledge base searches
  </Card>
</CardGroup>
