Documentation » Working with Fields in Pods » Simple Repeatable Fields

Simple Repeatable Fields

Simple Repeatable Fields will allow you to repeat many different types of fields.

Simple Repeatable Fields were added in Pods 2.9.

You can make fields repeatable so that you can enter multiple sets of values for many different field types.

Supported Pod Types and Field Types

  • Post Types (meta-based)
  • Taxonomies (meta-based)
  • Users (meta-based)
  • Comments (meta-based)
  • Media (meta-based)
  • Settings

NOTE: Table-based Pods are not currently supported. In the future, support for table-based storage will allow Repeatable fields to work for Advanced Content Types and any other table-based pod that you set up.

Supported Field Types

  • Text
    • Plain Text
    • Website
    • Phone
    • Email
    • Password
  • Date/ Time
    • Date/ Time
    • Date
    • Time
  • Relationships / Media
    • oEmbed
  • Paragraph
    • Plain Paragraph Text
    • WYSIWYG (Visual Editor)
  • Number
    • Plain Number
    • Currency
  • Other
    • Color Picker

Setting up a Repeatable field

When adding or editing your field, go to the “Repeatable” tab and you will find an option to make that field Repeatable.

Turning Repeatable on will now allow multiple values to be input, saved, and displayed.

Turning Repeatable off again will result in only the first value being input, saved, and displayed. If you disable Repeatable for a field that had multiple values saved, subsequent saves will overwrite all other values and only the single value saved will be left.

Inputting values with Repeatable fields

You can interact with a Repeatable field in the following ways:

  • If there is one value, you will not see a reorder or remove button
  • You can click “Add New” to add show another input that you can fill in
  • When there are multiple values, you may reorder them or remove values
  • There will always be at least one input even if the value is saved as empty

Saving values with Repeatable fields

Values will be saved to meta-based Pods across multiple meta values.

Displaying values with Repeatable fields

Normal magic tags will work as they do with Relationships with multiple values. Output will be comma-separated with a serial comma like: “Value 1, Value 2, and Value 3”

The more flexible way to interact with displaying these values is to use the [[each]] template tag which now has support for {@_value} to output an individual value and {@_index} to output the value position (starting at 0).

Other Helpful Documentation on Working with Fields in Pods

Avatar Field

Extends User Profile with a Gravatar field that is managed under the Media Library as opposed to using Gravatar.com

Code (Syntax Highlighting) Field

The Code (Syntax Highlighting) field is used for multiple line code content.

Color Picker Field

The Color Picker field is useful in situations where a color needs to be able to be chosen and customized.

Conditional Logic for Fields

Conditional Logic for Fields will allow you to show or hide a field based on the value of another field.

Currency Field

The Currency field is used to store numeric, integer, and float currency amounts.

Date / Time Field

The Date / Time field is used to store a date and time value with an easy to use date / time input.

Date Field

The Date field is used to store a date value with an easy to use date input.

Date time fields redirect

Email Field

The Email field allows you to store email addresses with additional validation checks.

File / Image / Video Field

The File / Image / Video field is used to store a relationship to Media attachment(s).

Heading Field

The Heading field is not a normal input field, it will output Heading text between your normal form fields to help organize the form.

HTML Content Field

The HTML Content field is not a normal input field, it will output as HTML itself between your normal form fields to help organize the form.

oEmbed Field

The oEmbed field is used to store a single URL that will use the oEmbed protocol to display remote content.

Password Field

The Password field is used to store single-line text with a basic password input form field.

Phone Field

The Phone field is used for telephone numbers in various formats.

Plain Number Field

The Plain Number field is used to store numeric, integer, and float values.

Plain Paragraph Text Field

The Plain Paragraph Text field is used for multiple line text values.

Plain Text Field

The Plain Text field is used for Simple Plain Text Values like a first name, last name, alphanumeric ID or value.

Relationship Field

The Relationship field is used to store related items on various objects in WordPress.

Settings: Advanced

Provides access to the Advanced field options when editing a field.

Settings: Field Details

Basic Field Settings (Label, Name, Description and Field Type) that apply to all Fields created in Pods.

Settings: Reserved List of Names

There are certain names you cannot use for Pod, Group, or Field names in Pods because they are reserved in WordPress or Pods for other uses.

Time Field

The Time field is used to store a date value with an easy to use time input.

Website Field

The Website field is used to store a URL or Website Address or Link to a Website.

WYSIWYG (Visual Editor) Field

The WYSIWYG (Visual Editor) field is used for multiple line HTML content.

Yes / No Field

The Yes / No field offers customizable labels and display options for checkbox, radio buttons, or a drop-down input.