Support Log in
All Features of Field Forge

35 Field Types

Field Forge ships with 35 field types organized into seven categories. 31 of the 35 types are in the free version; the compound types (Repeater, Group, Flexible Content, Clone) and PHP Blocks are Pro. Below is the reference with usage notes, configuration options, and ACF compatibility notes for developers migrating from Advanced Custom Fields.


Basic fields

Text

Single-line text input. Optional Character limit (the box stops at the limit, and a longer text is not saved), placeholder, prepend/append (for prefixes like “$” or suffixes like “/month”), and default value.

ACF equivalent: text
Returns: string

Textarea

Multi-line text input with configurable row count. Optional Character limit (the box stops at the limit, and a longer text is not saved) and placeholder. Returns plain text (no HTML formatting).

ACF equivalent: textarea
Returns: string

Number

Numeric input with min, max, and step values. Optional prepend/append for units. Validates as number on save.

ACF equivalent: number
Returns: number

Range

Slider input with min, max, and step. Visual alternative to Number for bounded values. Suits ratings, opacity, and percentage-like fields.

ACF equivalent: range
Returns: number

Email

Email input with client and server-side validation. Useful for contact fields and user records.

ACF equivalent: email
Returns: string

URL

URL input with validation. Supports relative and absolute URLs. Optional protocol requirement.

ACF equivalent: url
Returns: string

Password

Masked password input. The value is hidden while typing but stored as plain text in the database, so this is for visual privacy only. Use it for API keys or secret tokens you do not want shown on screen while editing.

ACF equivalent: password
Returns: string

Calculation

A read-only number computed from a formula over sibling fields, for example {price} * {qty}. Full calculation field →

ACF equivalent: none
Returns: the computed total


Content fields

Image

Media library picker with preview. Returns image metadata (ID, URL, alt, sizes). Configurable return format: Image Array, Image URL, or Image ID.

ACF equivalent: image
Returns: array / string / integer depending on return format

File

File upload/picker for any file type. Configurable allowed types (PDF, DOC, ZIP, etc.) and max size. Returns file metadata.

ACF equivalent: file
Returns: array / string / integer

WYSIWYG

TinyMCE rich text editor with media upload. Full WordPress editor features: headings, lists, links, images, embeds. Returns HTML.

ACF equivalent: wysiwyg
Returns: string (HTML)

oEmbed

Paste any URL (YouTube, Vimeo, Twitter/X, Spotify, SoundCloud, etc.) for automatic embed. WordPress’s built-in oEmbed discovery handles the preview.

ACF equivalent: oembed
Returns: string (embed HTML)

Gallery

Multi-image selection: an Add Images button opens the media library, and each thumbnail has a remove button. Returns an array of image metadata objects.

ACF equivalent: gallery
Returns: array of image arrays


Choice fields

Select

Dropdown from a list of choices, entered in the Choices box of the field group editor, one key : value pair per line. A field with the multiple setting is drawn as a multi-select; the field group editor has no input for that setting, and the ACF import copies it.

ACF equivalent: select
Returns: string / array (multi-select)

Checkbox

Multiple choices from a list. Layout setting: vertical (the default) or horizontal. Returns an array of selected values.

ACF equivalent: checkbox
Returns: array

Radio

Single choice from a list. Layout setting: vertical (the default) or horizontal. Returns the selected value.

ACF equivalent: radio
Returns: string

True/False

Boolean toggle with custom “on” and “off” labels. Returns true or false.

ACF equivalent: true_false
Returns: boolean

Button Group

Visual radio buttons rendered as a button group. Same logical behavior as Radio but different presentation.

ACF equivalent: button_group
Returns: string


Relational fields

Relationship

Posts chosen with a search box: type at least two characters, click a result to add the post, and click the remove button on a selected post to remove it. The search lists the posts of one post type: the first post type set on the field, or Posts when the field sets none. The field group editor has no input for the post type, and a field imported from ACF carries it. The search has no filter by taxonomy. The post editor saves the chosen posts as a comma-separated list of IDs, for example 16,17. With one post chosen, get_field() returns a WP_Post object, or the ID when the return format is id; with several posts chosen it returns that comma-separated text. A value imported from ACF is stored as an array of IDs and comes back as an array of WP_Post objects or IDs, depending on the return format.

ACF equivalent: relationship
Returns: WP_Post object / ID (one post chosen in the post editor), comma-separated IDs (several posts chosen in the post editor), array of WP_Post objects / array of IDs (value imported from ACF)

Post Object

The same search box as Relationship: type at least two characters and click a result to add the post. It lists the posts of one post type, chosen as for Relationship, and has no filter by taxonomy. Returns the selected post as a WP_Post object or as an ID, depending on the return format.

ACF equivalent: post_object
Returns: WP_Post object / integer

Page Link

A dropdown that lists the pages of the site (pages only: posts and custom post types are not listed). Returns the URL of the selected page.

ACF equivalent: page_link
Returns: string (URL)

Taxonomy

Terms of one taxonomy: the taxonomy set on the field, or Categories when the field sets none. The post editor shows the terms as a list of checkboxes, so several terms can be ticked; a field whose field_type setting is select shows a dropdown for one term. The field group editor has no input for the taxonomy or field_type setting, and a field imported from ACF carries them. Returns term objects or IDs, depending on the return format.

ACF equivalent: taxonomy
Returns: array of term objects / array of IDs (checkboxes), one term object / ID (dropdown)

User

A dropdown with the users of the site by display name; it selects one user. If the field sets roles (the role setting), only users with those roles are listed; the field group editor has no input for roles, and the ACF import does not copy them. There is no filter by capability and no multiple selection in the post editor. Returns a WP_User object, an array with ID, display_name and user_email, or an ID, depending on the return format.

ACF equivalent: user
Returns: WP_User object / array (ID, display_name, user_email) / ID

Link

A URL, link text, and an option to open the link in a new tab, stored as one value. The URL is sanitized on save.

ACF equivalent: link
Returns: array with url, title, and target (or only the URL, if the return format is URL)


jQuery fields

Date Picker

The browser’s own date input: you pick a date in the date box of the post editor and it is stored as Y-m-d, for example 2024-12-25. The field group editor has no format settings. If the field has a return_format (a field imported from ACF carries one), get_field() formats the stored date with it; otherwise it returns the stored string.

ACF equivalent: date_picker
Returns: string

Time Picker

The browser’s own time input. The field group editor has no format settings. If the field has a return_format (a field imported from ACF carries one), get_field() formats the stored time with it; otherwise it returns the stored string.

ACF equivalent: time_picker
Returns: string

Color Picker

The browser’s own color input: you pick a color in the color box of the post editor and it is stored as a hex color such as #ff5733. The field group editor has no opacity or alpha setting. get_field() returns the stored string.

ACF equivalent: color_picker
Returns: string

Google Map

A location stored as latitude, longitude, and address. Coordinates outside the valid range are dropped on save.

ACF equivalent: google_map
Returns: array with address, lat, and lng


Layout fields

Tab

Group fields into tabbed interface in the post editor. Not a value-storing field — it’s a layout helper.

ACF equivalent: tab
Returns: nothing (layout only)

Accordion

Collapsible field group. Users can expand/collapse to focus on specific sections of a long field group.

ACF equivalent: accordion
Returns: nothing (layout only)

Message

Informational text displayed in the editor. Not a field — used for instructions, warnings, or help text.

ACF equivalent: message
Returns: nothing (display only)


Pro compound fields

Repeater

Dynamic row-based fields. Add any combination of sub-fields to a row template, users add/remove/reorder rows at will. Supports nested repeaters.

ACF equivalent: repeater
Returns: array of row arrays (or use have_rows() / the_sub_field() loop)
Full repeater feature →

Group

Nested group of related fields under a single label. Non-repeating (use Repeater for repeating groups). Useful for logical organization of related data.

ACF equivalent: group
Returns: associative array

Flexible Content

Multiple row layouts per field. Each row can be a different layout (e.g., “hero,” “features,” “testimonials,” “CTA”). Users pick which layout to use for each row.

ACF equivalent: flexible_content
Returns: array of row arrays with acf_fc_layout key indicating layout
Full flexible content feature →

Clone

Reuse an entire field group inside another. Define shared fields once, clone wherever needed.

ACF equivalent: clone
Returns: depends on cloned fields


Blocks

PHP Blocks

Register Gutenberg blocks that render via PHP callback with access to custom fields. Uses acf_register_block_type() (ACF-compatible) or fieldforge_register_block_type() (native).

acf_register_block_type([
    'name'            => 'feature-card',
    'title'           => 'Feature Card',
    'render_callback' => 'my_feature_render_callback',
    'category'        => 'theme',
    'icon'            => 'star-filled',
]);

Full PHP blocks feature →


Field type comparison with ACF

The ACF import maps each ACF field type to the matching Field Forge type. The ACF Date Time Picker becomes a Date Picker, and an ACF field type that Field Forge does not know is imported as a Text field.


Adding custom field types

Field Forge has no API for adding a field type of your own. The list of field types is fixed in the plugin and no filter changes it, so a filter on fieldforge/field_types/register does nothing: Field Forge never fires that hook. The developer guide page about custom field types says the same and shows what to use instead.


Ready to use 35 field types?

See pricing →

31 of the 35 field types are in the free version. The compound types (Repeater, Group, Flexible Content, Clone) and PHP Blocks are unlocked on every paid plan.

Forge AI Assistant Online

Hi! I'm the Field Forge AI assistant. Ask me anything about the plugin — setup, features, troubleshooting, or development.

Just now
Powered by Forge AI · Browse docs