Docs/Integrations/Options Pages

Options Pages

An Options Panel is a standalone admin page under Pure Fields by default. This page covers its one deeper integration: mirroring it into Appearance → Customize with a live preview.

For registering a panel and its fields, see Developer Guide → Creating Field Groups. For building one with no code, see Builder Documentation → Option Builder.

Mirror a panel into the Customizer

Any option panel — built visually or in code — can appear in Appearance → Customize with live preview. It shares the exact same theme_mod storage, so nothing about how you read values changes.

Turn it on in code

PHP

TPMeta_Options::set_args( 'mytheme_options', [
    'menu_title'             => 'Theme Options',
    'customizer_integration' => true,   // ← mirror into Appearance → Customize
] );

Or turn it on in the visual builder

Open the panel in the Option Builder, go to Panel Settings, tick Customizer integration, and save. It appears under Appearance → Customize immediately.

Reading values is identical

PHP · theme template

// Panel or Customizer, it's the same theme_mod under the hood.
$color = tpmeta_get_option( 'accent_color', '#3362FF' );
$color = get_theme_mod( 'accent_color', '#3362FF' );

Every field type works in the sidebar

Colorpicker, select, switch, checkbox, tabs, repeater, post_select (Select2), datepicker, color_gradient, multicolor, image, gallery — plus a dedicated TinyMCE editor control — all render inside the Customizer with full UI.

If the panel disappears from the Customizer

Re-open Panel Settings, confirm Customizer integration is still ticked, and save — the flag must forward correctly from the builder each time the panel is edited. See FAQ.