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

# Adding default values to fields

> Set default values on ButterCMS fields to pre-populate common data, reduce repetitive entry, and maintain consistency across your content.

## What are default values?

Default values are preset values that automatically appear in fields when you create new content. They serve as starting points that you can keep or modify as needed.

<Tip>
  **Important distinction**:

  * **Required fields** must have a value before saving (marked with \*)
  * **Default values** provide a starting value but can be changed

  A field can be both required AND have a default value, ensuring it's never left empty.
</Tip>

### Benefits of default values

| Benefit            | Description                                   |
| ------------------ | --------------------------------------------- |
| **Time savings**   | Skip repetitive data entry for common values  |
| **Consistency**    | Ensure standard values across similar content |
| **Reduced errors** | Fewer blank fields and typos                  |
| **Guidance**       | Show content editors what's expected          |

## Where default values appear

Default values can be set for various field types in Pages, Collections, and Blog Posts. Click any of the field type cards below to see the field's configuration options.

<CardGroup cols={2}>
  <Card title="Text fields" icon="font" href="../../../core-concepts/field-types/short-text#field-configuration-options">
    Pre-filled text for headlines, descriptions, or labels
  </Card>

  <Card title="Dropdowns" icon="list" href="../../../core-concepts/field-types/dropdown-field#field-configuration-options">
    Pre-selected option from the available choices
  </Card>

  <Card title="Checkboxes" icon="square-check" href="../../../core-concepts/field-types/checkbox-field#field-configuration-options">
    Default checked or unchecked state
  </Card>

  <Card title="Number fields" icon="hashtag" href="../../../core-concepts/field-types/number-field#field-configuration-options">
    Default numeric values
  </Card>

  <Card title="Date fields" icon="calendar" href="../../../core-concepts/field-types/date-time-fields#field-configuration-options">
    Pre-filled date or timestamp values
  </Card>

  <Card title="Color fields" icon="palette" href="../../../core-concepts/field-types/color-field#field-configuration-options">
    Default color selections
  </Card>

  <Card title="Media fields" icon="image" href="../../../core-concepts/field-types/media-field#field-configuration-options">
    Default media file selections
  </Card>
</CardGroup>

## How default values work

<Tip>
  You can clear a default value from the field and leave it blank. If you frequently need to clear a default value, ask your developer if the default should be changed or removed.
</Tip>

### When creating new content

1. You create a new Page, Collection item, or Blog Post
2. Fields with default values appear pre-filled
3. You can keep the default or change it
4. Save or publish as normal

### When editing existing content

* Default values only apply to **new** content
* Existing content keeps its current values
* Changing a default value in the item schema doesn't update existing content

<Info>
  Default values are set by your developer when they configure the content types. If you need different defaults, contact your development team.
</Info>

## Common default value examples

**SEO fields**

| Field            | Common Default    | Reason                                   |
| ---------------- | ----------------- | ---------------------------------------- |
| Meta Title       | Page title        | Usually want the title as the meta title |
| Meta Description | Empty or template | Needs customization                      |

**Content fields**

| Field        | Common Default       | Reason                    |
| ------------ | -------------------- | ------------------------- |
| Status       | "Draft"              | Don't publish until ready |
| Author       | Current user         | Most likely author        |
| Publish Date | Today's date         | Common starting point     |
| Category     | Most common category | Saves time                |

**Boolean/checkbox fields**

| Field              | Common Default | Reason                     |
| ------------------ | -------------- | -------------------------- |
| Featured           | Unchecked      | Most items not featured    |
| Show in Navigation | Checked        | Usually want pages visible |
| Allow Comments     | Checked        | Enable by default          |

## Help text and field guidance

Fields may include **Help Text** below them that provides guidance on what information should be entered. This is configured by your developer to clarify expectations.

{/* IMAGE_SOURCE: file_path="knowledge-base/content-modeling-basics/content-fields.md" */}

![Field Help Text](https://cdn.buttercms.com/TrJCXgbRJGj5hpIQlR7T)

<Tip>
  Look for help text below the fields. It often explains what the default value represents and when you might want to change it.
</Tip>
