the_field()

Overview

Displays the value of a specific field.

Intuitive and powerful (much like ACF itself ?), this function can be used to load the value of any field from any location. Please note this function is the same as echo get_field( ... );

Parameters

the_field($selector, [$post_id], [$format_value]);
  • $selector (string) (Required) The field name or field key
  • $post_id (mixed) (Optional) The post ID where the value is saved. Defaults to the current post
  • $format_value (bool) (Optional) Whether to apply formatting logic. Defaults to true

Usage

Display a value from the current post

This example shows how to display the value of field ‘text_field’ from the current post.

<h2><?php the_field('text_field'); ?></h2>

Display a value from a specific post

This example shows how to display the value of field ‘text_field’ from the post with ID = 123.

<h2><?php the_field('text_field', 123); ?></h2>

Check if value exists

This example shows how to check if a value exists before displaying it.

<?php if( get_field('text_field') ): ?>
	
	<h2><?php the_field('text_field'); ?></h2>
	
<?php endif; ?>

Display a value from other places

$post_id = null; // current post
$post_id = 1; // post 1
$post_id = "option"; // options page
$post_id = "options"; // same as above
$post_id = "category_2"; // target a specific category
$post_id = "event_3"; // target a specific taxonomy (this tax is called "event")
$post_id = "user_1"; // target a specific user (user id = 1)

the_field( "text_field", $post_id );

Related

We use cookies to offer you a better browsing experience, analyze site traffic and personalize content. Read about how we use cookies and how you can control them in our Cookie Policy. If you continue to use this site, you consent to our use of cookies.