Options Pages are dedicated admin screens for managing data that is not tied to any single post or page — company contact info, social media links, footer text, global toggles, and more. This recipe walks through the complete setup.
Step 1: Decide How the Options Page Will Be Registered
Field Forge supports three registration paths — pick whichever fits the workflow:
- Admin UI (recommended, no code) — go to Field Forge > Options Pages, click Add New Options Page, fill in Page Title, Menu Slug, Capability, Parent Page, Icon, Position. Save. The menu item appears in the WordPress admin sidebar immediately. You can edit, soft-delete, or restore the page from the same list. The page row lives in the
wp_fieldforge_options_pagestable. - Auto-register from a field group (simplest one-step option) — give the field group an Options Page location rule and Field Forge creates a menu item with the group’s title as the menu label. No code, no separate page registration. The page is read-only in the Options Pages list — change the field group’s title to rename the menu item.
- Register explicitly via PHP (when the registration should ship with the theme) — drop a snippet into your theme’s
functions.php:
add_action('init', function () {
if (function_exists('fieldforge_add_options_page')) {
fieldforge_add_options_page([
'page_title' => 'Site Settings',
'menu_title' => 'Site Settings',
'menu_slug' => 'site-settings', // matches the location rule below
'icon_url' => 'dashicons-admin-settings',
'capability' => 'manage_options',
'position' => 80,
]);
}
});The acf_add_options_page() shim is also available for theme code migrating from ACF Pro.
Step 2: Add Field Groups
Create one or more field groups that target the Options Page. The options page draws one box for each field group, headed with the group title, and shows each field as its label and an input. Tab, Accordion and Message fields are not shown there, and the page does not use a field’s Instructions, Placeholder, Default, Required or Conditional Logic settings, so the tables below set only what the page uses (Rows for the Address field).
Field Group: Company Information- Go to Field Forge > Field Groups and click New Field Group, title it Company Information (the title becomes the heading of its box on the options page)
- Add these fields:
| Field | Type | Settings |
|---|---|---|
| Company Name | Text | None |
| Tagline | Text | None |
| Logo | Image | None |
| Favicon | Image | None |
| Phone Number | Text | None |
| Email Address | None | |
| Address | Textarea | Rows: 3 |
- Set Location Rules: Options Page is equal to Site Settings
- Save the field group
- Go to Field Forge > Field Groups and click New Field Group, title it Social Media
- Add these fields:
| Field | Type | Settings |
|---|---|---|
| URL | None | |
| Twitter / X | URL | None |
| URL | None | |
| URL | None | |
| YouTube | URL | None |
- Set Location Rules: Options Page is equal to Site Settings
- Save the field group
- Go to Field Forge > Field Groups and click New Field Group, title it Footer
- Add these fields:
| Field | Type | Settings |
|---|---|---|
| Copyright Text | Text | None |
| Footer Logo | Image | None |
| Show Newsletter Signup | True/False | None |
| Newsletter Heading | Text | None |
| Newsletter Subtext | Text | None |
- Set Location Rules: Options Page is equal to Site Settings
- Save the field group
Step 3: Content Manager Workflow
- Click Site Settings in the admin sidebar
- You see one box for each field group, headed with the group title: Company Information, Social Media and Footer
- Fill in the company name, upload the logo, and enter contact details in the Company Information box
- Paste your social profile URLs in the Social Media box
- Customize the copyright text and newsletter settings in the Footer box
- Click Save Options (the button is at the bottom of the page)
Changes apply site-wide immediately. Every page on the site that uses these values will update automatically.
Step 4: Using Options Data in Templates
Your developer accesses options data using the 'options' parameter:
get_field('company_name', 'options')in the headerget_field('social_facebook', 'options')for social iconsget_field('copyright_text', 'options')in the footer
Organizing with Sub-Pages
For complex sites, create sub-pages under the main options page:
- Site Settings (parent)
– Social Media — all social profile links
– Appearance — colors, fonts, layout preferences
– Integrations — Google Analytics ID, chat widget code, third-party scripts
Each sub-page gets its own field group. This keeps each settings screen focused and easy to navigate.
Tips for Options Pages
- Use one field group per section to organize related fields: each group gets its own box with its title as the heading, so you do not need a separate sub-page for every category
- Plan for empty valuesa field that has not been saved yet shows an empty input, because the options page does not apply default values, so give your template code a fallback for anything the site needs
- Put guidance in the label, for example “Logo (transparent PNG, 300×100 pixels)”: an options page shows only the label and the input, not Instructions or Message fields
- Do not rely on Conditional Logic here: an options page does not apply it, so every field in a group is always shown
- Keep it simpleonly put data here that truly needs to be site-wide. Per-page data belongs in regular field groups attached to specific posts or pages
—