Building a theme options page for your WordPress theme using ACF Pro

Custom WordPress Theme Options with ACF Pro

In the world of WordPress theme development, providing customisation options to users is essential. One effective way to achieve this is by creating a theme options page. A theme options page allows users to modify various aspects of their website’s appearance and functionality without touching the code directly. In this article, we will explore how to build a theme options page for your WordPress theme using the popular plugin Advanced Custom Fields (ACF) Pro.

What is a Theme Options Page?

A theme options page is a dedicated section within the WordPress admin area that enables users to customise their theme’s settings without requiring any coding knowledge. It typically includes fields for changing colors, typography, layouts, and other theme-specific options. By providing a user-friendly interface, theme options pages empower website owners to personalise their sites according to their preferences.

Benefits of Having a Theme Options Page

Having a theme options page offers several benefits for both developers and end-users. For developers, it simplifies the process of creating flexible themes that can be easily customised. It also enhances the user experience by providing a centralised location for making changes, eliminating the need to edit code files directly.

For end-users, a theme options page provides a hassle-free way to modify their website’s appearance and functionality. They can tweak colors, upload logos, set up social media links, choose layouts, and much more, all without the need for coding skills. This level of customisation empowers users to create unique and personalised websites.

Understanding ACF Pro

ACF Pro is a premium version of the Advanced Custom Fields plugin, which is widely used by WordPress developers for creating custom fields and meta boxes. ACF Pro offers additional features and functionalities compared to the free version, making it an excellent choice for building a theme options page.

With ACF Pro, you can create various field types, such as text inputs, checkboxes, radio buttons, image uploads, and more. It also allows you to organise these fields into logical groups called field groups, which simplifies the management of your theme options.

Setting up ACF Pro in WordPress

To get started, you’ll need to install and activate the ACF Pro plugin on your WordPress website. Once activated, you’ll have access to the necessary tools and functionalities for creating your theme options page.

Creating the Theme Options Page

Defining the Fields

When creating a theme options page, defining the fields is a crucial step. These fields determine the elements of your theme that users can customise, such as colors, fonts, logos, and layout options. By carefully considering the customisation possibilities you want to offer, you can create fields that correspond to each element, ensuring a comprehensive and user-friendly customisation experience.

ACF Pro provides a wide range of field types to choose from, allowing you to select the most appropriate one for each customisation option. For example, you can use color picker fields for selecting color schemes, text fields for entering custom text or URLs, image upload fields for logos or backgrounds, and select fields for choosing from predefined options.

When defining the fields, keep in mind the purpose and function of each element. Consider how users would interact with your theme and the specific aspects they would want to customise. This thoughtful approach ensures that the fields you create align with the needs and preferences of your target audience.

Grouping Fields with Field Groups

After defining the individual fields, it’s beneficial to group related fields together using field groups. Field groups allow you to organise your theme options logically and improve the user experience when navigating the options page.

Grouping fields helps users quickly locate the desired customisation options within the options page, enhancing usability and reducing confusion. For example, you can create a field group specifically for color-related options, another for typography settings, and another for layout preferences.

By grouping fields, you also facilitate easier management and maintenance of the options in the future. When you need to update or modify a specific group of fields, you can easily locate and make the necessary changes without having to sift through an extensive list of individual fields.

Adding Options to the Page

Once you have defined your fields and grouped them accordingly, it’s time to add these options to your theme options page using ACF Pro. ACF Pro provides a user-friendly interface that simplifies the process of assigning fields to the options page and specifying their order and layout.

Within the ACF Pro interface, you can easily drag and drop fields into the desired positions on the options page. This allows you to arrange the fields in a logical and intuitive order that makes sense to users. For instance, you might want to place the primary color customisation field at the top, followed by font-related options and then layout preferences.

ACF Pro also offers flexibility in terms of the layout and presentation of the options page. You can choose from different layout options, such as a single-column layout or a grid-based layout, depending on the complexity and visual organisation of your fields. Furthermore, you can add labels, descriptions, and default values to provide clarity and guidance to users when customising their themes.

Customising the Interface

ACF Pro provides various customisation options to tailor the appearance and behavior of the theme options page. These options allow you to enhance the user experience and ensure a seamless and engaging customisation process.

You can start by adding labels to each field, providing descriptive names that clearly indicate the purpose of the corresponding customisation option. Labels help users quickly identify the fields they want to modify, improving the overall usability of the options page.

In addition to labels, you can include descriptions for each field to provide additional information or instructions. These descriptions can guide users on how to use the specific customisation option or offer tips for achieving the desired effect. Clear and concise descriptions contribute to a more intuitive and user-friendly customisation experience.

ACF Pro also enables you to set default values for certain fields. Default values can be particularly useful when you want to provide a starting point or a recommended setting for users who might be unsure about the available options. By prefilling fields with sensible defaults, you make it easier for users to customise their themes while still allowing them the flexibility to change these values according to their preferences.

Conditional logic is another powerful customisation feature provided by ACF Pro. It allows you to show or hide fields based on certain conditions. For example, you can create a conditional rule that displays a font-related field group only when a specific font style is selected. This dynamic display of fields ensures that users only see relevant options, reducing clutter and confusion.

Tooltips are yet another customisation option that ACF Pro offers. Tooltips are small informational pop-ups that appear when users hover over certain elements. You can use tooltips to provide additional context, explanations, or examples for specific fields, helping users make informed decisions when customising their themes.

By leveraging these customisation features of ACF Pro, you can create a visually appealing and user-friendly theme options page. The interface customisation ensures that users can easily navigate the options, understand the purpose of each field, and make informed choices when personalising their themes.

Remember, the goal is to provide a seamless and intuitive customisation experience that empowers users to make their websites unique and visually appealing without requiring any coding knowledge.

Saving and Retrieving Theme Options

When users make changes through the theme options page, it’s crucial to save these modifications and retrieve them when needed. Advanced Custom Fields (ACF) Pro simplifies this process by automatically handling the storage and retrieval of the theme options. It provides convenient functions and methods that allow you to access the saved options and apply them to your WordPress theme.

To save the theme options, ACF Pro leverages the built-in functionality of WordPress to store the data in the database. The options are typically stored as an array or a serialised string, depending on your preference and the complexity of the options.

Retrieving the saved theme options is straightforward with ACF Pro. You can use the get_field() function to fetch individual field values or the get_fields() function to retrieve all the field values as an array. These functions require the field’s unique name or key as an argument, allowing you to retrieve the specific value you need.

Here’s an example of how you can retrieve a saved theme option using the get_field() function:

$color_scheme = get_field('color_scheme'); // Retrieves the value of the 'color_scheme' field
if ($color_scheme) {
  // Apply the selected color scheme to the appropriate elements
  echo '<style>';
  echo 'body { background-color: ' . $color_scheme . '; }';
  echo '</style>';

In this example, the get_field() function retrieves the value of the ‘color_scheme’ field. If the user has selected a color scheme, the code dynamically applies the chosen color to the background of the body element using CSS.

You can incorporate similar code snippets throughout your theme’s template files or functions.php file to retrieve and apply the saved theme options wherever needed. This allows you to dynamically adjust the appearance and behavior of your theme based on the user’s customisation choices.

// Retrieving and applying a font choice
$font_choice = get_field('font_choice');
if ($font_choice) {
  echo '<style>';
  echo 'body { font-family: ' . $font_choice . ', sans-serif; }';
  echo '</style>';

In this example, the value of the ‘font_choice’ field is retrieved and applied to the body element’s font-family using CSS. This ensures that the chosen font is reflected throughout the theme.

// Retrieving and applying a logo upload
$logo = get_field('logo');
if ($logo) {
  echo '<img src="' . $logo['url'] . '" alt="' . $logo['alt'] . '">';

In this example, the logo image uploaded by the user is retrieved and displayed within the theme using an <img> tag. The URL and alt text of the uploaded logo are accessed through the returned array from the get_field() function.

By integrating the theme options seamlessly into your theme, you provide a cohesive and personalised experience for the website visitors. Users can see their chosen options reflected in real-time, enhancing the visual appeal and uniqueness of their websites.

Remember to consider the context and specific requirements of your theme when applying the retrieved options. You may need to adapt the code examples to match the structure and design of your theme, ensuring a seamless integration of the theme options.

ACF Pro simplifies the process of saving and retrieving theme options, enabling you to provide a customisation experience that reflects the preferences of your users and enhances the overall user experience.

Testing and Troubleshooting

After implementing the theme options page and applying the customisation choices to your theme, it’s crucial to thoroughly test your website. Verify that the options work as intended across different devices, browsers, and scenarios. This testing phase ensures that the theme options are reliable and deliver the expected results.

In case you encounter any issues or unexpected behavior, ACF Pro provides extensive documentation and a supportive community. You can consult the documentation, browse forums, or even seek assistance from the ACF Pro team to troubleshoot and resolve any problems you may encounter.


Building a theme options page using ACF Pro offers an efficient and user-friendly approach to empower website owners with customisation capabilities. By following the steps outlined in this article, you can create a comprehensive theme options page that enables users to personalise their WordPress themes without touching any code. The combination of ACF Pro’s features and the flexibility of WordPress allows for endless possibilities in creating tailor-made websites.


Can I use ACF Free instead of ACF Pro?

While ACF Free is a powerful plugin, ACF Pro offers advanced features specifically designed for creating theme options pages. It provides a more extensive range of field types and customisation options, making it the recommended choice for building a comprehensive theme options page.

How can I customise the appearance of the theme options page?

ACF Pro allows you to customise the interface of the theme options page using various options such as labels, descriptions, default values, and conditional logic. You can also apply custom styling using CSS to match the design of your theme.

Are there any limitations to what I can include in the theme options page?

As long as you use the appropriate field types and follow best practices, you can include a wide range of customisation options in your theme options page. However, it’s important to consider the performance impact of certain features and ensure that the options align with your theme’s overall design and functionality.

Can I use ACF Pro to create options for specific post types?

Yes, ACF Pro allows you to create custom fields and options not only for themes but also for specific post types. This flexibility allows you to enhance the editing experience for different types of content within your WordPress website.

Is it possible to import/export theme options?

ACF Pro provides functionality to export and import theme options, allowing you to transfer settings between different installations or back them up for future use. This feature simplifies the migration process and ensures consistency across multiple environments.

Get Started

Ready to get going? Click on one of the buttons below and tell us more about the web design, web development or website fix you need and we will be in touch with you within hours with some options to get your business moving in the right direction