When you create a new field from the Edit Pod screen by clicking the “Add Field” button, you’ll be presented with the Field Details section for your new field first. These are identical for every field (with the exception of Relationship fields).
To further control each different type of field, you’ll need to go to the next tab below “Field Details” that is specific to each field type. Those settings are detailed on the corresponding field type documentation pages.
Contents
Quick Start
- Give your new field a Label, which is what will be displayed next to the form input for this field.
- Give your field a Name, which is what you will use to programmatically reference this field with Magic Tags or PHP. This will automatically populate with a best guess from the Label.
- Optionally put a Description, which will be displayed below the form input and can be used to further identify your field or provide content entry instructions.
- Choose a Field Type from the list of field types.
- If necessary, check the box for “Required” if the input must be filled in with a non-empty value during content entry.
For further details, refer to each section below.
Label
This is the human readable ‘label’ for the field. This is also what will be included in the <label for="field">Label</label> that is displayed next to the form input. You should use something short but descriptive.
Name
This is the programmatic or code based name for the field. This is what will be stored in the Database (wp_postmeta, wp_termmeta, wp_usermeta, etc) as the actual name of the field value. The field name must be unique for the content type. You should take care to avoid using a field name that is used by other plugins or your theme for this content type or you may see unexpected results. You are restricted from creating fields with any names from the Reserved List of Names.
Description
The field description can be used to provide content entry instructions or additional details to describe the input field you’ve created. This is displayed below the field inputs when managing content. You should use this input to provide helpful information for your users who will be handling data input to avoid confusion or provide clarification.
Field Type
You can choose one of the many available field types that we support with Pods.
Options: Required
If you need to make sure the field is completed when saving the post, you should turn this option on for the field. When required, the field will not be allowed to be saved with an empty value.
Options: Unique
For Advanced Content Types, you also have an option available to ensure that values are unique before they are saved. This might be useful when you want to store a field value that should not be allowed to be entered again.
Options: Repeatable
If you would like to input multiple values for this field, you can turn on the Repeatable Fields feature.