Description
This function is deprecated. Please use the have_rows() function instead.
This function is used within a while-loop to loop through each row of a Repeater or Flexible Content field.
Unlike have_rows(), this function will take a step through the available rows each time it is called, causing undesired results when also used within an if-statment.
Parameters
has_sub_field( $field_name, $post_id );
$field_name(string) (Required) The name of the Repeater or Flexible Content field to be retrieved. e.g. ‘gallery_images’$post_id(mixed) (Optional) The post ID where the value is saved. Defaults to the current post.
Return
(bool) True if a row exists.
Change Log
- Deprecated in version 4.3.0
Examples
Loop through Repeater field
This example demonstrates how to loop through a repeater field called “gallery_images”.
<?php if( get_field('gallery_images') ): ?>
<?php while( has_sub_field('gallery_images') ): ?>
<img src="<?php the_sub_field('image'); ?>" alt="<?php the_sub_field('alt'); ?>" />
<?php endwhile; ?>
<?php endif;
Loop through a Flexible Content field
This example demonstrates how to loop through a Flexible Content field called “content” and display various layouts.
<?php while( has_sub_field("content") ): ?>
<?php if( get_row_layout() == "paragraph" ): ?>
<div>
<?php the_sub_field("content"); ?>
</div>
<?php elseif( get_row_layout() == "file" ): ?>
<div>
<a href="<?php the_sub_field("file"); ?>" ><?php the_sub_field("name"); ?></a>
</div>
<?php elseif( get_row_layout() == "featured_posts" ): ?>
<div>
<h2><?php the_sub_field("title"); ?></h2>
<?php the_sub_field("content"); ?>
<?php if( get_sub_field("posts") ): ?>
<ul>
<?php foreach( get_sub_field("posts") as $p ): ?>
<li><a href="<?php echo get_permalink($p->ID); ?>"><?php echo get_the_title($p->ID); ?></a></li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
</div>
<?php endif; ?>
<?php endwhile; ?>
Loop through nested Repeater fields
This example demonstrates how to loop through nested Repeater fields and display the sub field data.
<?php if( get_field('parent_repeater') ): ?>
<?php while( has_sub_field('parent_repeater') ): ?>
<div>
<?php if( get_sub_field('child_repeater') ): ?>
<ul>
<?php while( has_sub_field('child_repeater') ): ?>
<li><?php the_sub_field('item'); ?></li>
<?php endwhile; ?>
</ul>
<?php endif; ?>
</div>
<?php endwhile; ?>
<?php endif;
Loop through nested Repeater fields (from another $post ID)
This example demonstrates how to loop through nested Repeater fields from a different post with the ID of 123.
Note: You don’t need to specify the $post_id for any sub field functions.
<?php if( get_field('parent_repeater', 123) ): ?>
<?php while( has_sub_field('parent_repeater', 123) ): ?>
<div>
<?php
if( get_sub_field('child_repeater') ): ?>
<ul>
<?php while( has_sub_field('child_repeater') ): ?>
<li><?php the_sub_field('item'); ?></li>
<?php endwhile; ?>
</ul>
<?php endif; ?>
</div>
<?php endwhile; ?>
<?php endif;
Supercharge Your Website With Premium Features Using ACF PRO
Speed up your workflow and unlock features to better develop websites using ACF Blocks and Options Pages, with the Flexible Content, Repeater, Clone, Gallery Fields & More.
