Overview
The Divi Dynamic Content Helper plugin adds a “Custom Fields” panel to the Divi Builder so you can view and edit field values without switching to the WordPress backend. This is very innovative, and nothing else is available like this. It supports ACF, Pods, ACPT, and native WordPress fields.
This custom panel within the Divi Builder is useful in many scenarios. A client might need to update their store hours or contact info directly in the builder without seeing the confusing backend, a content editor might change promotional messages that display dynamically on the page, or a team member could manage event dates or business details without accessing the backend. The main benefit is keeping the custom fields directly within your normal workflow in the builder without switching back and forth, or you just want to avoid the scary backend mess.
How The Settings Work
You can access the settings by going to the WordPress admin area and clicking the Divi Dynamic Content Helper link under the Pee-Aye Creative menu. This brings you to the plugin settings interface. Click the Custom Fields tab on the left sidebar, then the Divi Builder Window subtab.
Enable the setting called “Edit Custom Fields In The Divi Builder” after reviewing the description. This setting is disabled by default, which means the behavior matches that of Divi by default, which does not have a custom fields panel in the builder.
With the setting enabled, go ahead and open the Divi 5 builder. On the left sidebar, look for the new custom fields icon that is added by our plugin. This opens the custom fields window, as shown in the screenshot below.
Supported Custom Field Integrations
We started with support for WordPress native custom fields and Advanced Custom Fields (ACF), then added support for ACPT and Pods in version 2.2, and possibly others coming next based on your requests.
We designed our panel to work with the native fields for those who prefer a simpler experience or those sites that don’t need advanced fields. If your site does not have a custom fields plugin installed, the panel will display native WordPress custom fields (assuming they are enabled), similar to how they work in the backend. You will see any existing fields from that page with a button to add a new field.
If a custom field plugin like ACF, ACPT, or Pods is installed and active but no fields are assigned to the current location, the panel will show a friendly message with guidance on where to assign fields.
WordPress Core Custom Fields
WordPress core custom fields are fully supported by Divi Dynamic Content Helper. You can use these fields with the Custom Fields panel in the Divi Builder, as well as with advanced features like inline variables and global dynamic content sources. This makes it easy to manage, display, and dynamically populate content across your site, all within the familiar WordPress environment.
Advanced Custom Fields (ACF)
Most of the ACF free and pro fields are supported by Divi Dynamic Content Helper, including Options Pages. You can edit ACF field values directly in the Divi Builder’s Custom Fields panel and connect to them with features like inline variables and global dynamic content sources.
ACPT
ACPT custom fields are supported by most of the Divi Dynamic Content Helper, such as inline variables and global dynamic content sources. We are working on adding support for editing ACPT values directly in the Divi Builder’s Custom Fields panel to give you full control over dynamic content without leaving the builder.
Pods Framework
Pods custom fields are supported by most of the Divi Dynamic Content Helper, such as inline variables and global dynamic content sources. We are working on adding support for editing Pods values directly in the Divi Builder’s Custom Fields panel to give you full control over dynamic content without leaving the builder.
Supported Features
We carefully designed our plugin to integrate custom fields into the Divi Builder as naturally and smoothly as possible. Beyond basic field compatibility, we’ve added support for a number of thoughtful features to ensure that the editing experience feels familiar, polished, and complete, matching Divi’s user experience. Below is a detailed look at some of the key features our fields support.
Please refer to our other integration documentation to learn more about the unique field types and features supported by each custom field plugin, including ACF, Meta Box, Pods, and WordPress core custom fields.
Default Value Support
If a default value is set in the custom field settings, it will be automatically populated in the field when editing a post or page for the first time. This means the field will already have a value filled in, even before anything is typed, which is just as you’d expect from how custom fields work in the WordPress backend. This makes it easy to guide users on new pages or posts, ensuring consistent input or pre-fill content as needed.
Placeholder Value Support
If a placeholder is defined for a custom field, it will appear as expected inside the input when the field is empty, offering helpful hints or instructions to guide the user. This is especially useful when handing off sites to clients or teams, helping ensure the field is used correctly.
Hover State Support
When you hover over any custom field in our custom fields window, the border darkens slightly to match Divi’s native interface behavior. At the same time, the Info and Reset to Default icons appear on the right side of the field. This makes it easy to access help text or return the field to its default state without cluttering the UI.
Focus State Support
When you click into a custom field to begin editing, the field border changes to match your selected Divi Builder accent color. This behavior matches that of standard Divi settings and helps clearly indicate which field is active, especially when editing longer forms with many inputs.
Description Support
When a custom field includes a description, it will appear using Divi’s familiar interface pattern. Just like other settings in the Divi Builder, a small information icon (i) appears next to the field label. Clicking this icon reveals the description, offering helpful context or guidance about the field’s purpose.
This integration ensures that field descriptions feel native to Divi and remain out of the way until needed, providing a clean editing experience while still supporting detailed instructions when necessary.
Reset To Default Support
Many native Divi settings include a reset icon to quickly restore the original value. Since the Divi Custom Fields Helper plugin is built to feel right at home inside the Divi interface, we knew this familiar feature had to be part of the experience. To match this expected behavior, we added full support for resetting custom field values as well.
If you enter a value in a custom field and want to revert it back to its default, you can click the reset icon, just like you would with any other Divi setting. Clicking the reset icon will clear any content or repopulate any default value. This mirrors how custom fields behave natively in the WordPress backend and how normal fields work in Divi’s interface.
Validation Support
Custom fields marked as required or with specific input rules will display error or validation messages just like they would in the WordPress backend, but now inside the Divi Builder in our custom fields window. Common messages include ones like “This field is required,” “Invalid email address,” and “Value must be a valid URL.” These messages appear in orange text just below the field, and relevant fields themselves are outlined in orange to make the issue easy to see.
When a field is marked as required, an asterisk appears next to the label. If a value is missing or doesn’t meet the validation criteria, you won’t be able to save, just as you’d expect in the WordPress backend. The save button will turn orange and say “Errors Found—Please Check,” and you cannot click to save until the validation or error is resolved.
Dark Mode Support
Divi includes a built-in dark mode that switches the entire interface to a darker palette. This helps reduce eye strain or match a user’s system preferences.
All custom fields shown in the Divi Custom Fields Helper fully support dark mode. The field and custom window interface adapts to either light or dark mode, ensuring that field controls, labels, messages, and styles remain legible and consistent.
Color Scheme Support
The Divi Builder includes a setting that lets users change the accent color scheme of the interface. This can be useful for differentiating sites, teams, or workflows, with options like Blue (default), Purple, Green, Orange, and Red.
Our custom fields window fully supports this native Divi feature. It automatically adapts to the selected color scheme, so everything remains visually consistent across the builder interface.
Supported Native WordPress Custom Fields
If your site does not have a plugin like ACF, Pods, or Meta Box installed, the Divi Dynamic Content Helper will automatically detect and display native WordPress custom fields. This ensures the plugin remains useful and functional even in the most minimal setups. The interface mirrors the layout in the default WordPress editor, with an input field for the field name, an input field for the field value, and Update and Delete buttons.
Editing Native Fields In The Divi Builder
Each custom field displays with two input fields, one for the field name and one for the field value, just like you would expect from the standard WordPress layout in the backend. Below each field group, there are Update and Delete buttons for saving changes or removing fields. A divider line separates each field group for clear visual organization.
Add New Custom Fields
The Add Custom Field button is always available at the bottom of the custom fields panel in the builder. This allows you to create new fields at any time, whether or not any fields already exist. You can click the Cancel button as needed when adding if you change your mind. Once a field is added, it will appear immediately in the list above and can be edited or removed just like in the backend.
Supported Plugin Fields
Below is a complete list of the field types currently supported by the Divi Dynamic Content Helper plugin. Each field includes notes, examples, and screenshots where applicable to help you understand how it behaves in the Divi Builder.
Some field types may still be under development or have limited compatibility due to technical constraints. We’re actively working to expand support, and we’ll note any fields that require special handling or custom solutions.
Text Field
The text field is a standard single-line input that can be used for almost any kind of short text content. It’s great for things like subtitles, names, labels, or other quick bits of information. Features such as required fields, character limits, descriptions, placeholders, and default values are fully supported.
Text Area Field
The text area field is designed for multi-line text, making it ideal for longer content like testimonials, bios, or brief descriptions. It supports required fields, character limits, descriptions, placeholders, and default values.
Number Field
The number field only accepts numeric input and gives you control over things like step size, minimum and maximum values. It works well for use cases like prices, quantities, or numeric settings. You can also use placeholders, set default values, add descriptions, and make the field required.
Range Field
The range field lets users adjust a numeric value using a slider or by entering the number directly. This is a good choice for values like ratings, percentages, or any setting with a defined range. Supported features include step size, minimum and maximum values, placeholders, descriptions, default values, and required fields.
Email Field
The email field ensures that the input follows a valid email address format and will display an error message if it doesn’t. This is useful for contact forms, account details, or any field where you need to collect an email address. Required fields, placeholders, descriptions, and default values are all supported.
URL Field
The URL field is used to collect valid web addresses and requires a format that begins with https://. This is perfect for linking to external resources, portfolios, product pages, or any custom link fields. It supports required fields, descriptions, placeholders, and default values. It will require an HTTP or HTTTPS protocol.
Password Field
The password field hides the input behind asterisks for privacy, making it suitable for login forms or access-controlled content. It supports required fields and descriptions.
Image Field
The Image field lets you upload an image or select one from the WordPress Media Library to store in the custom field. It is perfect for things like profile pictures, graphics, feature images, or icons throughout your design. Features like setting the field as required and writing descriptions are supported. At this time, limiting the allowed file types is not available.
File Field
The File field is ideal for attaching documents like PDFs, audio clips, videos, or any other file type needed for your content. While it can be used for images, it’s more commonly used for general file uploads such as brochures, forms, or product sheets. It supports the required and description settings, and honors file type restrictions, so if you’ve set it to only allow certain types (like PDF or PNG), only those will appear as selectable in the media library. It also supports the ACF “Limit media library choice” setting, allowing you to choose whether the user can choose from files already uploaded to that post or pick from the full media library.
WYSIWYG Field
This field provides a rich text editor similar to the standard WordPress editor, making it ideal for longer-form content such as bios, detailed descriptions, or formatted instructions. It supports required fields, descriptions, and default values. You can choose whether to show the Visual or Text (HTML) editing tabs and whether to display the “Add Media” button for easy file or image insertion.
oEmbed Field
This field allows you to embed external content such as YouTube videos, tweets, or other supported media by simply pasting a URL. It’s perfect for showcasing dynamic media content without needing to use embed codes. It supports required fields and descriptions. Since Divi doesn’t have a built-in UI for oEmbed, we created a custom input interface to make it feel native. The embed height and width are automatically handled dynamically, so the ACF “Embed Size” setting is not used.
Select Field
The select field allows users to choose a single option from a predefined dropdown list. It’s useful for setting things like sizes (small, medium, large), selecting a preferred contact method, choosing a membership plan, selecting shipping options, choosing difficulty levels, or any other value where you want to limit the input to a fixed set of choices. The field supports required status, descriptions, placeholders, default values, and the ability to allow a null selection.
Although ACF supports multiple select values, the Divi Builder does not currently support multiselect. If you need to allow multiple selections, consider using a checkbox field instead.
Checkbox Field
The Checkbox field lets users select one or more options from a list of choices. This is commonly used for selecting multiple items, such as selecting interests, choosing from multiple options, or agreeing to terms and conditions. It is styled to match the Divi Builder with full support for dark mode and dynamic color based on the Divi Builder color scheme. Features like setting the field as required, adding a default value, and including a description are supported.
Radio Field
The Radio Button field lets you present users with a list of choices where only one option can be selected. It’s ideal for situations where only one option can be selected, like choosing a payment method (Credit Card, PayPal, etc.) or a product size (Small, Medium, Large). Because Divi does not have a built-in radio button setting style, we created a custom design that blends naturally into the Divi Builder. The field supports dynamic color styling based on the Divi Builder color scheme, adapts to dark and light mode, and includes features like making the field required, adding a description, setting a default value, and allowing a null (no selection) state.
Button Group Field
The Button Group field lets users select one option from a set of choices. This is useful for selecting preferences, like choosing a product feature (e.g., Standard, Premium, Deluxe) or selecting an option (e.g., Yes or No). In ACF, the options are displayed as connected buttons. Since Divi does not have a built-in button group UI, the Divi Custom Fields Helper plugin displays this field as a searchable dropdown instead. Features like setting the field as required, setting a default value, and allowing a null value (no selection) are supported.
True/False Field
The True/False field works just like the standard on/off toggles you see throughout the Divi Builder interface, providing a simple and familiar experience. This is useful for settings where users need to enable or disable a feature, such as opting in for newsletters or enabling a service. The value stored by the field is either true (on) or false (off). Features like making the field required and adding a description are supported, so you can ensure users make a selection when needed.
Google Map Field
The Google Map field lets users enter an address and instantly view the location on a map within the Divi Builder. It’s an excellent choice for displaying business locations, event venues, or any physical address. After entering the address, click the Find button to preview the map. This field supports required status and descriptions, along with settings for controlling the map zoom level and map height for better layout control.
Date & Time Picker Field
The Date Time Picker field allows users to select both a date and time using a visual calendar and time inputs. It is useful for scheduling events, setting deadlines, booking appointments, or any situation where both date and time details are needed. The field supports making it required and adding a description.
Date Picker Field
The Date Picker field allows users to select a date from a calendar, but does not include a time option. This is great for capturing birthdays, event dates, or reservation dates, making it easy for users to select the correct date. The field supports required settings and descriptions.
Time Picker Field
The Time Picker field allows you to select a specific time without a date. It’s useful for setting business hours, appointment times, or reminders that only need a time, not a full date. The field supports required settings and descriptions.
Color Picker Field
The Color Picker field allows users to select a color through the familiar Divi color picker interface. This is perfect for setting brand colors, background colors, or any other customizable color value within your design. It supports required settings, descriptions, and includes the ability to toggle transparency on or off.
Link Field
The Link field is perfect for call-to-action buttons, external resources, or related page links. It allows users to enter a URL and link text and choose whether the link should open in a new tab. The field appears as a simple set of inputs, one for the URL, one for the link text, and a checkbox for the “open in new tab” option. The field supports required validation and includes the field description.
Post Object Field
The Post Object field lets the user select a single post, page, or custom post type, which is useful for referencing related content throughout the site. It uses a searchable dropdown and supports filtering by post type, post status, and taxonomy. It also supports required field validation and a description setting, and the ability to allow a null selection.
Page Link Field
The Page Link field allows users to select a link to a post, page, or other content type directly within the Divi Builder. It’s ideal for building internal navigation, linking to related content, or connecting custom modules to relevant posts. Required fields and descriptions are also supported, along with filters for post type, post status, and taxonomy, and the option to allow archive URLs is supported.
Relationship Field
The Relationship field is a powerful option for selecting and relating multiple posts, pages, or custom post types within the Divi Builder. It works like a multi-select dropdown input, allowing you to search for and select multiple items from the list. Selected items appear as badges inside the field, styled to match the modern Divi UI, just like the new variable token design. This provides a seamless editing experience that is consistent with other Divi interfaces.
This field behaves similarly to the Post Object and Page Link fields, but with additional flexibility. Although the original ACF field includes filtering controls like taxonomy and post type filters, our integration simplifies this with a built-in live search bar that effectively replaces the need for separate filters. You can quickly find and add relevant content without leaving the builder. You can also disable the search bar in the ACF field settings if you choose.
The field supports all the ACF settings related to filtering, including options for limiting available selections by post type, post status, taxonomy terms, and more. Only items matching those filters will appear in the dropdown, ensuring clean, relevant relationships. It also fully supports the description and required settings, making it a robust and flexible choice for dynamic site relationships directly in Divi.
Taxonomy Field
The Taxonomy field lets users select terms from a specific taxonomy, such as categories, tags, or custom taxonomies. It appears as a list of checkboxes, allowing multiple selections. This field is useful for tagging content or organizing posts based on taxonomy terms. It currently supports descriptions and required field validation. It also supports the “Load Terms” setting in ACF, which means it will always load the terms attached to the current post, ignoring any values you select.
User Field
The User field lets users select a registered WordPress user from a list. This is useful for assigning a user to a post, event, or another content type, like choosing a speaker for an event or an author for a blog post. It supports required settings, descriptions, the option to allow null values, and limiting users by role, ensuring only relevant users are available for selection.
Gallery Field (ACF Pro Only)
The Gallery field is only available in ACF Pro, but we’ve added support for it in the Divi Dynamic Content Helper. It allows users to select and display multiple images in a gallery layout using Divi’s familiar gallery field interface. It supports the required field setting and a field description. Other ACF gallery settings are not currently supported.
