Get values from an options page

Last updated Jun 30, 2022

Overview

All the template functions (get_field, the_field, etc) can be used to load values from an options page, however, a second parameter is required to target the options page. This is similar to passing through a $post_id parameter to target a specific post object.

The $post_id parameter needed is a string containing the word ‘option’ or ‘options’.

Please note that although it is possible to create multiple options pages, all values are saved and loaded using ‘option’ as the $post_id.

Examples

Display a field

<p><?php the_field('field_name', 'option'); ?></p>

Retrieve a field

<?php

$variable = get_field('field_name', 'option');

// do something with $variable

?>

Display a sub field

Note that when inside of a have_rows loop, you do not need to use the $post_id parameter for any sub field functions (get_sub_field, the_sub_field)

<?php if( have_rows('repeater_field_name', 'option') ): ?>

    <ul>

    <?php while( have_rows('repeater_field_name', 'option') ) : the_row(); ?>

        <li><?php the_sub_field('title'); ?></li>

    <?php endwhile; ?>

    </ul>

<?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.

Explore Features View Pricing

PRO Features
ACF Blocks
Options Pages
PRO Fields
Repeater
Flexible Content
Gallery
Clone

Related