Field Forge offers 32 field types across the free and PRO plans. This reference provides a complete overview of each type, when to use it, and its key configuration options.
Text and Number Fields
| # | Field Type | Plan | What It Does | When to Use It |
|---|
| 1 | Text | Free | Single-line text input | Titles, names, short labels, phone numbers, any brief text up to about 100 characters |
| 2 | Textarea | Free | Multi-line text input without formatting | Descriptions, bios, summaries, addresses — when you need multiple lines but not rich formatting |
| 3 | Number | Free | Numeric input with optional min, max, and step | Prices, quantities, ratings, years, any purely numeric value |
| 4 | Range | Free | Horizontal slider that returns a number | Percentages, skill levels, satisfaction scores — when a visual slider is more intuitive than typing a number |
| 5 | Email | Free | Text input with email validation | Contact emails — the browser validates the format automatically |
| 6 | URL | Free | Text input with URL validation | Website links, social profiles, external resources |
| 7 | Password | Free | Masked text input (shows dots) | API keys, secret values — the text is hidden while typing but stored as plain text in the database |
| Option | Description |
|---|
| Default Value | Pre-fills the field with a starting value |
| Placeholder | Gray hint text shown when the field is empty |
| Required | When enabled, the post cannot be saved without this field |
| Character Limit | Maximum number of characters allowed (Text, Textarea) |
| Min / Max | Minimum and maximum numeric values (Number, Range) |
| Step | Increment amount for the number controls (Number, Range) |
| Prepend / Append | Text or symbol displayed before or after the input (e.g., “$” or “kg”) |
| Wrapper Width | Percentage width of the field in the editor (25%, 33%, 50%, 75%, 100%) |
Media Fields
| # | Field Type | Plan | What It Does | When to Use It |
|---|
| 8 | Image | Free | Selects a single image from the Media Library | Photos, logos, thumbnails, hero backgrounds, author avatars |
| 9 | File | Free | Selects a single file from the Media Library | PDFs, documents, spreadsheets, ZIP files, any downloadable file |
| 10 | WYSIWYG | Free | Rich text editor (same as the WordPress block editor toolbar) | Formatted content with bold, italic, links, lists — a mini editor within a field |
| 11 | oEmbed | PRO | Paste a URL to embed media (YouTube, Vimeo, Twitter, Spotify) | Embedded video or audio content — just paste the URL and it previews automatically |
| 12 | Gallery | PRO | Select and reorder multiple images | Photo galleries, product image sliders, portfolio grids — when one image is not enough |
| Option | Description |
|---|
| Return Format | How the value is returned: Image Array (full data), Image URL (just the link), or Image ID (just the attachment ID) |
| Preview Size | The thumbnail size shown in the editor (Thumbnail, Medium, Large) |
| Library | Restrict to uploaded media only, or allow URL input |
| Min / Max (Gallery) | Minimum and maximum number of images |
| Allowed File Types (File) | Restrict to specific extensions (e.g., pdf, docx, zip) |
| Toolbar (WYSIWYG) | Full toolbar or Basic toolbar (fewer formatting options) |
| Tabs (WYSIWYG) | Show Visual tab, Text tab, or both |
Choice Fields
| # | Field Type | Plan | What It Does | When to Use It |
|---|
| 13 | Select | Free | Dropdown menu — pick one option | Categories, statuses, country selectors — best when there are 5+ options |
| 14 | Checkbox | Free | Multiple selection with checkboxes | Tags, features, certifications — when editors can pick several options at once |
| 15 | Radio | Free | Single selection with radio buttons | Layout choices, priority levels — when all options should be visible at once (fewer than 6 options) |
| 16 | True/False | Free | On/off toggle switch | Feature flags, visibility toggles, yes/no decisions — “Show banner?”, “Is featured?” |
| 17 | Button Group | Free | Styled inline buttons for single selection | Alignment (left/center/right), size (S/M/L), style choices — visually clean alternative to radio |
| Option | Description |
|---|
| Choices | The list of options (value : label pairs) |
| Default Value | The pre-selected option |
| Allow Null | Whether “no selection” is valid (Select) |
| Multiple | Allow selecting more than one option (Select only) |
| Return Format | Return the value, the label, or both as an array |
| Layout | Vertical or Horizontal layout (Radio, Checkbox) |
Relation Fields (PRO)
| # | Field Type | Plan | What It Does | When to Use It |
|---|
| 18 | Relationship | PRO | Select multiple posts with search and drag-to-reorder | Related articles, featured products, curated content lists |
| 19 | Post Object | PRO | Select a single post from a searchable dropdown | Featured post, parent reference, “Read next” link |
| 20 | Page Link | PRO | Select an internal page and returns its URL | CTA button destinations, menu links, redirect targets |
| 21 | Taxonomy | PRO | Select terms from any taxonomy (categories, tags, custom) | Highlighted categories for a sidebar, featured tags for a widget |
| 22 | User | PRO | Select a WordPress user from a searchable list | Author override, team lead assignment, reviewer selection |
| Option | Description |
|---|
| Post Type (Relationship, Post Object) | Restrict to specific post types (e.g., only Products) |
| Taxonomy (Relationship, Post Object) | Filter by taxonomy terms |
| Filters | Searchable filters shown in the selection interface |
| Min / Max (Relationship) | Minimum and maximum number of selected posts |
| Return Format | Post Object (WP_Post) or Post ID |
| Allow Null | Whether “no selection” is valid |
Date and Color Fields
| # | Field Type | Plan | What It Does | When to Use It |
|---|
| 23 | Date Picker | Free | Calendar popup for selecting a date | Event dates, deadlines, publication dates, milestones |
| 24 | Time Picker | PRO | Time selection input | Appointment times, business hours, event schedules |
| 25 | Color Picker | Free | Color selection with hex input and visual wheel | Brand colors, section backgrounds, accent customization |
| Option | Description |
|---|
| Display Format | How the date appears in the editor (e.g., “April 10, 2026”) |
| Return Format | How the date is returned in code (e.g., “Y-m-d” for 2026-04-10) |
| First Day of Week | Start the calendar on Sunday or Monday (Date Picker) |
| Enable Opacity | Allow alpha/opacity selection (Color Picker) |
Layout Fields (No Data Storage)
| # | Field Type | Plan | What It Does | When to Use It |
|---|
| 26 | Tab | Free | Splits fields into named tabs within the metabox | Organizing large field groups — e.g., “Content” tab, “Settings” tab, “SEO” tab |
| 27 | Accordion | Free | Creates collapsible sections with clickable headers | When you want sections that can be expanded individually — good for optional fields |
| 28 | Message | Free | Displays read-only text or HTML in the editor | Instructions, warnings, formatting guidelines — “Upload images at 1920×1080 for best results” |
Layout fields do not store any data and do not affect performance. Use them freely to improve the editing experience.
Compound Fields (PRO)
| # | Field Type | Plan | What It Does | When to Use It |
|---|
| 29 | Repeater | PRO | A list of rows, each with the same sub-fields | Team members, FAQs, features, pricing tiers — any list of similar items |
| 30 | Group | PRO | A single set of related sub-fields bundled together | Address block, CTA section, author bio — related fields that appear exactly once |
| 31 | Flexible Content | PRO | Multiple layout types that editors choose from and reorder | Page builders, landing pages, modular content sections |
| 32 | Clone | PRO | Reuses fields from another field group | Shared field sets (e.g., a “CTA Block” used across multiple field groups) |
| Option | Description |
|---|
| Sub-fields | The fields contained within each row (Repeater), group (Group), or layout (Flexible Content) |
| Min / Max Rows (Repeater) | Limits on how many rows editors can add |
| Display (Repeater) | Table (compact), Block (cards), or Row (expandable) |
| Layouts (Flexible Content) | Named section templates with their own sub-fields |
| Min / Max Layouts (Flexible Content) | Limits on how many times each layout can be used |
| Button Label (Repeater, Flexible Content) | Custom text for the “Add Row” or “Add Layout” button |
| Seamless Style (Group) | Removes the visual border so sub-fields blend into the parent |
Quick Reference: Choosing the Right Field Type
| I need to capture… | Use this field type |
|---|
| A short piece of text (title, name, label) | Text |
| A longer piece of text without formatting | Textarea |
| Formatted rich text with bold, links, lists | WYSIWYG |
| A number (price, quantity, rating) | Number |
| A yes/no decision | True/False |
| A single choice from several options | Select (5+ options) or Radio/Button Group (under 5) |
| Multiple choices | Checkbox |
| A single image | Image |
| Multiple images | Gallery (PRO) |
| A downloadable file | File |
| An embedded video | oEmbed (PRO) |
| A date | Date Picker |
| A time | Time Picker (PRO) |
| A color | Color Picker |
| A link to another post on the site | Post Object (PRO) or Page Link (PRO) |
| A list of related posts | Relationship (PRO) |
| A list of repeating items | Repeater (PRO) |
| Related fields that appear once | Group (PRO) |
| Mix-and-match page sections | Flexible Content (PRO) |
| Reused fields from another group | Clone (PRO) |
| Organizational tabs | Tab |
| Collapsible sections | Accordion |
| Help text for editors | Message |