Loop Fields

About This Article

This article covers built-in WordPress dynamic data FIELDS that are automatically available in Builderius without custom queries. All fields shown work immediately when you add them to elements.

Understand the Tables

Table Columns

Dynamic Data Tag - The tag automatically added when you select from the Dynamic Data dropdown, using curly bracket syntax: {{field_name}}

Description - What content this tag will display on your website

Type - What kind of data this field returns

Data Types Explained

String - Text content like "How to Build Better Websites" or "https://example.com/my-post"

Int - Whole numbers like post ID 142 or loop index 3

Mixed - Variable content that depends on your custom fields and the current loop item

How to Use This Data

Click the Dynamic Data Icon available on each Builderius element. Search for what you want and add it.

Built-in loop availability - All data shown works inside Collection elements when using built-in WordPress arrays (wp data sources), ACF repeater fields, or MetaBox repeater/group fields

Loop Scope

Data about the current item when looping through built-in WordPress arrays using Collection elements. Available inside Collection element templates when your data source is a built-in WordPress array like [[wp.archive.posts_query.posts]], [[wp.nav_menu__main_menu]], or ACF repeater fields Pro feature, or MetaBox group/repeater fields Pro feature - includes current item fields, relationships, and custom fields automatically.

Custom Query Loops

Custom GraphQL query loops work differently - only fields you explicitly query for are available as {{field_name}}. See the Custom Query Scope article for details on defining your own loop data structure.

Built-in Data Tags (Direct Use)

These fields work immediately inside Collection element templates when using wp data sources - no setup required.

Current Item Access (Posts Loop)

Dynamic Data Tag	Description	Type
{{ID}}	Current post ID	Int
{{post_title}}	Current post title	String
{{post_content}}	Current post content	String
{{post_excerpt}}	Current post excerpt	String
{{post_date}}	Current post publication date	String
{{post_datetime}}	Current post publication datetime	String
{{post_modified_date}}	Current post last modified date	String
{{post_modified_datetime}}	Current post last modified datetime	String
{{post_status}}	Current post status	String
{{post_type}}	Current post type	String
{{link}}	Current post URL	String

Current Item Featured Image (Posts Loop)

Dynamic Data Tag	Description	Type
{{post_featured_image.file_url}}	Current post featured image URL	String
{{post_featured_image.alt_text}}	Current post featured image alt text	String
{{post_featured_image.caption}}	Current post featured image caption	String
{{post_featured_image.sizes}}	Current post featured image size data	Mixed

Current Item Taxonomy (Posts Loop)

Dynamic Data Tag	Description	Type
{{category_names}}	Current post category names	String
{{category_links}}	Current post category HTML links	String
{{tag_names}}	Current post tag names	String
{{tag_links}}	Current post tag HTML links	String

Current Item Author (Posts Loop)

Dynamic Data Tag	Description	Type
{{post_author.name}}	Current post author username	String
{{post_author.ID}}	Current post author ID	Int
{{post_author.display_name}}	Current post author display name	String
{{post_author.first_name}}	Current post author first name	String
{{post_author.last_name}}	Current post author last name	String
{{post_author.email}}	Current post author email	String
{{post_author.avatar}}	Current post author avatar URL	String

Current Item Meta & Custom Fields (Posts Loop)

Dynamic Data Tag	Description	Type
{{meta_field__field_name}}	Current post meta field (replace field_name with actual meta key)	Mixed
{{acf_field__field_name}}	Current post ACF field (replace field_name with your ACF field name)	Mixed
{{mb_field__field_name}}	Current post MetaBox field (replace field_name with your MetaBox field name)	Mixed

Helper Array FIelds

Dynamic Data Tag	Description	Type
{{.}}	Current array wildcard item value (print all available fields inside loop)	String
{{index}}	Current array order number (print array item number)	String

Usage Examples

Archive Posts Loop

<!-- Collection element data source: [[wp.archive.posts_query.posts]] -->
<!-- Inside Collection template: -->

<article class="post-card">
  <header>
    <h2><a href="{{link}}">{{post_title}}</a></h2>
    <div class="meta">
      <time>{{post_date}}</time>
      <span>by {{post_author.display_name}}</span>
    </div>
  </header>
  
  <img src="{{post_featured_image.file_url}}" alt="{{post_featured_image.alt_text}}">
  
  <div class="content">
    <p>{{post_excerpt}}</p>
  </div>
  
  <footer>
    <span>Categories: {{category_links}}</span>
    <span>Tags: {{tag_links}}</span>
  </footer>
</article>

ACF Repeater

<!-- Collection element data source: [[wp.post.acf_field__gallery_items]] -->
<!-- Inside Collection template: -->

<div class="gallery-item">
  <img src="{{acf_field__image}}" alt="{{acf_field__caption}}">
  <div class="item-content">
    <h3>{{acf_field__title}}</h3>
    <p>{{acf_field__description}}</p>
    <span class="item-order">{{acf_field__sort_order}}</span>
  </div>
</div>

<!-- Another ACF repeater example -->
<!-- Collection element data source: [[wp.post.acf_field__team_members]] -->
<!-- Inside Collection template: -->

<div class="team-member">
  <img src="{{acf_field__photo}}" alt="{{acf_field__name}}">
  <h3>{{acf_field__name}}</h3>
  <p class="position">{{acf_field__position}}</p>
  <p class="bio">{{acf_field__bio}}</p>
  <a href="mailto:{{acf_field__email}}">{{acf_field__email}}</a>
</div>

Metabox Group

<!-- Collection element data source: [[wp.post.mb_field__product_features]] -->
<!-- Inside Collection template: -->

<div class="feature-item">
  <div class="feature-icon">
    <img src="{{mb_field__icon}}" alt="{{mb_field__feature_name}}">
  </div>
  <div class="feature-content">
    <h4>{{mb_field__feature_name}}</h4>
    <p>{{mb_field__description}}</p>
    <span class="priority">{{mb_field__priority_level}}</span>
  </div>
</div>

<!-- Another MetaBox group example -->
<!-- Collection element data source: [[wp.post.mb_field__testimonials]] -->
<!-- Inside Collection template: -->

<blockquote class="testimonial">
  <p>"{{mb_field__quote}}"</p>
  <footer>
    <cite>
      <strong>{{mb_field__client_name}}</strong>
      <span>{{mb_field__company}}</span>
      <span>{{mb_field__rating}}/5 stars</span>
    </cite>
  </footer>
</blockquote>