Skip to main content

Advanced Custom Fields

The Loop and Field tags support the following ACF field types.

Loops & Logic also adds an optional Tangible Template field type to the ACF field groups interface. This field type can be enabled under Tangible > Settings.

Basic fields​

These field types can be displayed simply with the Field tag.

  • Text
  • Textarea
  • Number
  • Email
  • URL
  • Password

Content fields​

WYSIWYG editor​

Use the acf_editor attribute.

<Field acf_editor=field_name />

OEmbed​

Use the acf_oembed attribute.

<Field acf_oembed=field_name />

Template​

This is for the ACF field type "Tangible Template" (under Content section) added by the plugin.

Use the acf_template or template attribute to render the template field.

<Field acf_template=field_name />

Date fields​

Date, date-time, and time picker​

Use the acf_date, acf_date_time, or acf_time attribute.

<Field acf_date=field_name />
<Field acf_date_time=field_name />

Date format​

Optionally, use the format and locale attributes to apply date formatting.

<Field acf_date=field_name format="l j F Y" locale=fr />

For format syntax and available locales, see Format: Date.

Use format=default to use the site setting from Settings -> General -> Date Format.

Choice​

Select​

Use the acf_select attribute for a field with single selected value.

<Field acf_select=field_name />

For multiple values, use the Loop tag.

<Loop acf_select=field_name>
  <Field />
</Loop>

Checkbox​

Use the Loop tag and acf_checkbox attribute.

<Loop acf_checkbox=field_name>
  <Field />
</Loop>

Radio​

Use the acf_radio attribute.

<Field acf_radio=field_name />

True/False​

Use the acf_true_false attribute.

<If acf_true_false=field_name>
  TRUE
<Else />
  FALSE
</If>

Choice labels​

Use the Field tag and field=label to get the label of the chosen value.

<Field acf_select=field_name field=label />

Use the Loop tag and field=labels for fields with multiple values.

<Loop acf_select=field_name field=labels>
  Label: <Field />
</Loop>

Choices​

Use the Loop tag and field=choices to loop through the available choices of a field.

<Loop acf_select=field_name field=choices>
  Value: <Field value /><br/>
  Label: <Field label /><br/>
</Loop>

It is a list of choices with value and label fields.

Relational​

For these field types, use the Loop tag to get associated content.

Use the Field tag as a shortcut to get a subfield. For example:

<Field acf_file=field_name field=title />

File​

Use the acf_file attribute.

<Loop acf_file=field_name>
  <Field title />
</Loop>
<Field acf_file=field_name field=url />

See Attachment Loop for available fields.

Image​

Use the acf_image attribute.

<Loop acf_image=field_name>
  <Field title />
</Loop>
<Field acf_image=field_name field=url />

See Attachment Loop for available fields.

Use the acf_link attribute.

<Loop acf_link=field_name>
  <Field title />
</Loop>
<Field acf_link=field_name field=url />

Available fields are: url, title, and target.

Post object​

Use the acf_post attribute.

<Loop acf_post=field_name>
  <Field title />
</Loop>

See Post Loop for available fields.

Relationship​

Use the acf_relationship attribute.

<Loop acf_relationship=field_name>
  <Field title />
</Loop>

See Post Loop for available fields.

Taxonomy​

Use the acf_taxonomy attribute.

<Loop acf_taxonomy=field_name>
  <Field title />
</Loop>

See Taxonomy Term Loop for available fields.

User​

Use the acf_user attribute.

<Loop acf_user=field_name>
  <Field full_name />
</Loop>

See User Loop for available fields.

Use the acf_gallery attribute.

<Loop acf_gallery=field_name>
  <Field title />
</Loop>

See Attachment Loop for available fields.

Nested​

Repeater​

Use the acf_repeater attribute.

<Loop acf_repeater=field_name>
  <Field title />
</Loop>

All field types are supported inside a repeater loop, including another repeater field.

Flexible content​

Use the acf_flexible attribute.

<Loop acf_flexible=field_name>
  <Field title />
</Loop>

All field types are supported inside a flexible content loop, including another flexible content field.

Layout​

Use the field layout to check which layout was chosen for each item.

<If field=layout value=layout_1>
  Layout 1
<Else if field=layout value=layout_2 />
  Layout 2
</If>

Group​

To display multiple fields, use the acf_group attribute.

<Loop acf_group=group_field_name>
  <Field sub_field_name />
  <Field another_sub_field />
</Loop>

To display a single field within the group, combine the group field name with the sub-field name using an underscore.

<Field group_field_name_sub_field_name />

Fields from options page​

ACF provides a function called acf_add_options_page to add options pages to store global settings.

To get fields from an options page, use the Field or Loop tag with the attribute from=options.