ACF Fields

ACF integration

This article covers Advanced Custom Fields (ACF) integration with built-in dynamic data in Builderius. ACF fields appear automatically in the Dynamic Data dropdown when you create and populate them, and can be added to any element without custom queries.

How ACF Fields Appear in Builderius

ACF fields are automatically available in the Dynamic Data dropdown. Builderius supports all field types in all WordPress locations. There are 3 types of fields:

• Simple Fields (text, number, boolean...) appear as single options you can click to add
• Object Fields (images, relationships, post objects, images...) appear within expandable options as subfields
• Array Fields (repeaters, multiselect relationships...) can be used as Collection data sources

Adding Simple and Complex Fields

1. Simple ACF fields appear the same as built-in fields and can be added with a single click
2. Complex ACF fields that have subfields (these are object fields) appear as toggles. Once you click such a field, it expands to show subfields
3. ACF Subfields act the same way as simple fields and can be added with a single click

Adding fields with multiple instances

Multiple instance fields expose their data as an array. They have to be added to Collection element, and their content is then added same way as other loops. These fields are:

• Repeater fields
• Gallery fields
• Flexible Content fields
• Relationship fields (with multiple option toggle on)
• Select fields (with multiple option toggle on)
• Any field with multiple option toggle on

Naming Convention

Simple Fields

Context	Dynamic Data Tag Pattern	Description
Posts/Pages	[[wp.post.acf_field__field_name]]	Text, number, boolean, date, color picker fields
Options Pages	[[wp.acf_options_field__field_name]]	Site-wide simple field values
Users	[[wp.user.acf_field__field_name]]	User profile simple field values
Terms	[[wp.archive.term.acf_field__field_name]]	Taxonomy simple field values
Nav Menu	{{acf_field__field_name}}	Menu item simple field values (Collection context)

Complex Fields (Objects with Subfields)

Context	Dynamic Data Tag Pattern	Description
Posts/Pages	[[wp.post.acf_field__field_name.subfield]]	Image, file, post object, user, taxonomy fields
Options Pages	[[wp.acf_options_field__field_name.subfield]]	Site-wide object fields with expandable properties
Users	[[wp.user.acf_field__field_name.subfield]]	User object fields with expandable properties
Terms	[[wp.archive.term.acf_field__field_name.subfield]]	Taxonomy object fields with expandable properties
Nav Menu	{{acf_field__field_name.subfield}}	Menu item object fields (Collection context)

Array Fields (Collection Data Sources)

Context	Dynamic Data Tag Pattern	Description
Posts/Pages	[[wp.post.acf_field__field_name]] → {{acf_field__subfield}}	Repeater, gallery, flexible content fields
Options Pages	[[wp.acf_options_field__field_name]] → {{acf_field__subfield}}	Site-wide repeater fields for global content
Users	[[wp.user.acf_field__field_name]] → {{acf_field__subfield}}	User repeater fields (skills, experience, etc.)
Terms	[[wp.archive.term.acf_field__field_name]] → {{acf_field__subfield}}	Taxonomy repeater fields
Nav Menu	{{acf_field__field_name}} → {{acf_field__subfield}}	Menu item repeater fields (nested Collections)

Field Types in Dynamic Data

Simple Field Types

• Text, Textarea, Number, Email, URL → Direct values: [[wp.post.acf_field__field_name]]
• Select, Radio, Checkbox → Selected values: [[wp.post.acf_field__field_name]]
• True/False → Boolean values: [[wp.post.acf_field__field_name]]
• Date/Time fields → Formatted dates: [[wp.post.acf_field__field_name]]
• Color Picker → Hex color values: [[wp.post.acf_field__field_name]]

Complex (object) Field Types

• Image → Expandable with .file_url, .alt_text, .caption subfields
• File → Expandable with .url, .filename, .filesize subfields
• Post Object → Expandable with .title, .link, .excerpt, etc.
• User → Expandable with .display_name, .email, .avatar, etc.
• Taxonomy → Expandable with .name, .slug, .description, etc.

Array Field Types

• Repeater → Use as Collection data source: [[wp.post.acf_field__repeater_name]]
• Gallery → Use as Collection data source for multiple images
• Post Object (Multiple) → Use as Collection for multiple posts
• User (Multiple) → Use as Collection for multiple users

Usage Examples

Simple Fields

Text, Number, Boolean Fields:

<!-- Event page example -->
<div class="event-details">
  <h2>[[wp.post.title]]</h2>
  <div class="date">[[wp.post.acf_field__event_date]]</div>
  <div class="time">[[wp.post.acf_field__event_time]]</div>
  <div class="venue">[[wp.post.acf_field__venue_name]]</div>
  <div class="capacity">Max attendees: [[wp.post.acf_field__max_attendees]]</div>
  <div class="type">Online Event: [[wp.post.acf_field__online_bool]]</div>
</div>

Complex Fields

Image and File Fields:

<!-- Portfolio item -->
<figure class="portfolio-item">
  <img src="[[wp.post.acf_field__featured_work.url]]" alt="[[wp.post.acf_field__featured_work.alt]]">
  <figcaption>[[wp.post.acf_field__featured_work.caption]]</figcaption>
</figure>

<!-- File item -->
<div class="portfolio-pdf">
  <a href="[[wp.post.acf_field__portfolio.url]]">Download [[wp.post.acf_field__portfolio.subtype]]</a>
</div>

Repeater Fields

Repeater Fields (Collection Elements):

<!-- Testimonials repeater -->
<!-- Collection data source: [[wp.post.acf_field__testimonials]] -->
<!-- Inside Collection template: -->
<blockquote class="testimonial">
  <p>"{{acf_field__quote}}"</p>
  <footer>
    <cite>{{acf_field__author_name}}</cite>
    <span>{{acf_field__company}}</span>
    <div class="rating">{{acf_field__rating}}/5 stars</div>
  </footer>
</blockquote>