ExpressionEngine® User Guide

Legacy Documentation

You are using the documentation for version 4.3.8. Go here for the latest version.

Channel Fields Tab

Control Panel Location: Developer ‣ Channels ‣ New/Edit Channel ‣ Fields

This tab allows you to create and assign fields and field groups to your channel.

Permission Restrictions

  • Access settings: Design & Content
  • Channels: Create Channel Fields
  • Channels: Edit Channel Fields
  • Channels: Delete Channel Fields

Actions

Add Group

Opens the New Field Group modal.

Add Field

Opens the New Field modal.

Fields

Field groups

A multi-select comprised of all field groups. A channel can have multiple field groups or no field groups.

Fields

A multi-select comprised of all fields, including those in field groups. A channel can have any combination of fields and field groups, and fields can be used in more than one channel.

New Field Group Modal Fields

Name

Field group name.

Fields

Fields to include in the new field group.

New Field Modal Fields

Field Settings

Type

ExpressionEngine includes the following types of fields for use in your Channel Entries (add-ons can include their own as well):

  1. Checkboxes: Checkbox fields display a list of options in the publish form that you choose by clicking the checkboxes.
  2. Date: Date fields are designed to store dates. Next to the date field in your PUBLISH page you’ll see a calendar and two options for your date:
    • Localized: The date will be localized to the timezone of each user browsing your site.
    • Fixed: The date will NOT be localized and instead shown at the exact date/time you submit.
  3. File: File fields store uploaded files and images, and utilize the build in file browser for your publishers to upload and insert files.
  4. Grid: The Grid field in ExpressionEngine provides a way to group fieldtypes in repeatable rows.
  5. Multi Select: Multi Select field types give a list of options in a standard multiple selection form control, letting publishers choose any or none of the available items.
  6. Radio Buttons: Radio buttons are similar to Checkbox fields, except that you can only select one of the items from the list.
  7. Relationships: The Relationship field is a special and very powerful field type. It enables you to create relationships between two or more channels so you can show content from one entry within another.
  8. Rich Text Editor: The Rich Text Editor is a text entry box with multiple lines that uses the built-in Rich Text Editor.
  9. Select Dropdown: Select fields are simply a standard HTML <select> drop-down list. You can define the contents of the list manually or pre-populate it from another field.
  10. Text: The Text field is a single input line for text. It is the type of field you might use for a title, name, or other short information.
  11. Textarea: The Textarea field is a standard text entry box with multiple lines. This is often used for the body text of entries.

Name

This is the descriptive name for the field. This is a required field and it may contain spaces or punctuation. Unlike the Field Name, the label does not need to be unique within the system, so you can use the same descriptive label on multiple fields in different field groups. The label is what will be displayed next to the field on the entry form in your PUBLISH page.

Short Name

This is the internal or “short name” for the field. This is a required field and must be a single word with no spaces or punctuation. The field name must be unique within the system, which means that you cannot have two field groups each containing a field with the field name of “body”. The short name is typically used as the variable name in your Channel Entries Tag

Note

Some words are reserved and cannot be used. Please see Reserved Words for details.

Instructions

These are instructions for authors on how or what to enter into the field when submitting an entry. The instructions will appear below the Field Label in your PUBLISH page.

Require field?

You may determine whether this field is required. If the field is required and the user leaves it blank, upon submission they will receive an error message prompting them to correct it.

Hide field?

Here you determine whether or not the field will be shown or hidden on the publish page by default. If you choose “No”, the field will be collapsed by default and in order to enter content into the field you will first have to open using the link provided on the publish page.

Field Options

Each field type may have additional field options. See the individual field types for details.