Migrate from Kirki / Redux — Tutorials — Pure Metafields

Docs/Tutorials/Migrate from Kirki / Redux

Migrate from Kirki / Redux

Already have an options framework? Paste your existing Kirki or Redux PHP and Pure Meta converts it into a native panel you can edit, save, and bake.

Pure Metafields admin screen: kirki
The Kirki / Redux importer. Choose the source (Kirki or Redux), paste your PHP, click Detect Sections & Fields to preview what was parsed, then Import as New Panel.

Open Pure Fields → Option Builder. On the empty state — or via New Panel — you'll see two import buttons: Kirki and Redux. Pick the one matching your source.

  1. Paste your framework code

    Drop in the PHP. Kirki understands both the static API (Kirki::add_panel, add_section, add_field) and the OOP form (new \Kirki\Field\Color([...])). Redux understands Redux::set_args(), set_section() and set_field().

  2. Review the parsed preview

    Pure Meta parses the code and shows a tree: how many sections and fields it detected, each field's mapped type and ID, and the proposed panel title and option name. Adjust the title / opt-name before committing.

  3. Import & save

    Confirm to drop the converted sections and fields into a new panel. It opens in the builder as a draft — review, then Save to persist. From there it's a normal Pure Meta panel: edit fields, enable the Customizer, or bake to PHP.

What converts

Panels, sections and their fields, with types remapped to the nearest Pure Meta equivalent (see the table below). Section icons from Elusive/FontAwesome are mapped to Dashicons. Choice fields stored as {key: label} objects are normalized to Pure Meta's option format automatically.

What's skipped

Purely structural / non-field entries don't carry over: info, divide, group, tab, import_export, callback, hook and custom_link. Unknown field types fall back to text so nothing is lost silently — re-pick the type after import if needed.

It converts code, not saved values

This migrates the field definitions from your source PHP. After importing, set defaults or re-enter values in the panel, then save. To carry live values between Pure Meta sites, use Export / Import instead.

Type mapping reference

Kirki / Redux source→ Pure Meta type
text url number slider spinner passwordtext
textareatextarea
editor raweditor
code ace_editorcode
color color-alpha color_rgba background link_colorcolorpicker
gradientcolor_gradient
select sortable paletteselect
checkbox toggle switchswitch
radio radio_buttonset button_setradio_buttonset
radio-image image_selectradio_image
image upload media cropped_imageimage
typographytypography
dimensions spacing borderspacing
dimensiondimension
multicheck · multicolor · repeatersame name
datedatepicker
post-typepost_select
section info divide group tab callback hookskipped (structural)