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

# CRM Basics & Custom Fields

> Control how contacts are captured and define custom fields for contacts and companies

<Info>
  **Plan availability:** Startup or higher. See [Plans & Billing](/features/settings/plans).
</Info>

CRM Basics controls how your agent captures people who contact you and lets you tailor the data you keep on contacts and companies.

## Contact Scope

Choose whether contacts are shared across every agent in the workspace or kept private to a single agent.

<CardGroup cols={2}>
  <Card title="Workspace" icon="building">
    Every agent in this workspace sees the same contacts. Useful when multiple agents serve the same customers and you want a unified record.
  </Card>

  <Card title="Just this agent" icon="user">
    Contacts are isolated to this agent only. Useful when agents serve completely separate audiences and you don't want their records mixed.
  </Card>
</CardGroup>

<Tip>
  Most teams should start with **Workspace** so a customer who calls one agent and texts another shows up as a single contact.
</Tip>

## Auto-Capture Settings

Toggle whether the agent automatically saves a new contact whenever someone reaches out on a given channel.

<AccordionGroup>
  <Accordion title="Phone Calls">
    When enabled, an inbound call will create a contact using the caller's phone number. The contact is saved even if the call is brief.
  </Accordion>

  <Accordion title="Text Messages">
    When enabled, an inbound text creates a contact using the sender's phone number.
  </Accordion>

  <Accordion title="Emails">
    When enabled, an inbound email creates a contact using the sender's email address. Their name is captured too if it's available in the message.
  </Accordion>
</AccordionGroup>

<Note>
  Auto-capture only adds the basics — phone number or email. Richer details (full name, company, custom fields) are filled in by the agent during the conversation or by you on the contact page.
</Note>

## Custom Fields

Custom fields let you store extra information on contacts and companies that's specific to your business — things like lead score, account type, or referral source.

### Field Types

<CardGroup cols={2}>
  <Card title="Text">Single-line text</Card>
  <Card title="Number">Numeric values</Card>
  <Card title="Date">A date</Card>
  <Card title="Date & Time">A specific date and time</Card>
  <Card title="Dropdown">Pick one option from a list you define</Card>
  <Card title="Multi-select">Pick multiple options from a list you define</Card>
  <Card title="Checkbox">A simple yes / no toggle</Card>
  <Card title="URL">A web address</Card>
  <Card title="Email">An email address</Card>
  <Card title="Phone">A phone number</Card>
</CardGroup>

### Adding a Custom Field

<Steps>
  <Step title="Open Settings > CRM Basics">
    Find the **Contact Custom Fields** or **Company Custom Fields** card.
  </Step>

  <Step title="Click Add">
    A dialog opens for the new field.
  </Step>

  <Step title="Name the field">
    Enter a clear label (e.g., "Lead Score" or "Account Type") and an optional description to help your team understand when to use it.
  </Step>

  <Step title="Pick a field type">
    Choose the type that matches the data you'll store. For Dropdown or Multi-select, list each option on its own line.
  </Step>

  <Step title="Mark it required (optional)">
    Toggle "Required field" if the field must be filled in to save a contact or company.
  </Step>

  <Step title="Create">
    The field appears immediately on every contact or company in the workspace.
  </Step>
</Steps>

### Editing and Deleting Fields

You can rename a field, edit its description, change its options (for dropdowns), or toggle whether it's required at any time. The field type itself can't be changed once created — delete the field and create a new one if you need a different type.

<Warning>
  Deleting a field removes it from your forms and contact pages. Existing values stored in that field are preserved on each record but become read-only.
</Warning>

<Card title="Back to Settings" icon="gear" href="/features/settings/overview">
  Return to Settings overview
</Card>
