Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/dylanfisher/wp-field-migrator/archive/refs/heads/main.zipUpdates itself. It ships its own updater (Plugin Update Checker), so new versions appear under Dashboard → Updates.
Field Migrator (wp-field-migrator) adds an admin interface to preview and migrate values from one field into another for a selected post type.
Access
- WordPress Admin ->
Tools->Field Migrator - URL:
/wp-admin/tools.php?page=wp-field-migrator
Current capabilities
- Source -> target field mapping for a selected post type.
- Field pickers grouped by:
- Core Fields
- ACF Fields (Active)
- ACF Fields (Inactive)
- Detected Meta Keys
- Optional
Custom meta key...fallback for source and target. - Optional toggle to show internal/private keys (
_meta_key). - Paginated preview (
Page,Per Page). Preview All Changes (Append)to stream/append preview rows across all posts in async batches.Stop Preview Appendingto halt append mode.Export Dry-Run CSV (All Posts)to download full preview output without writing changes.- Async migration across all posts with configurable
Migration Batch Size. - Efficient cursor/keyset batching (
ID > last_id) to avoid large offset queries. - Skips rows with empty source values and rows where target already matches source.
- Run history with per-run status/totals, failed IDs, and downloadable CSV run reports (including per-batch logs).
- Nonce + capability checks for actions.
Core field names
You can map to/from these special core fields:
core:post_titlecore:post_contentcore:post_excerpt
Example
Migrate description -> location on exhibition posts:
- Open
Tools > Field Migrator. - Set
Post Typetoexhibition. - Set
Source Fieldtodescription(or select from dropdown). - Set
Target Fieldtolocation(or select from dropdown). - Click
Preview Changesand review results. - Optionally run
Preview All Changes (Append)for full-scan preview. - Click
Run Migration (Async, All Posts).
Safety
- Back up your database before using this tool.
- Migrations can irreversibly modify post data.
- Test first on staging.
Notes
- Migration copies source values into target values.
- Source fields are not cleared automatically.
Releases
1 release.
Tag
Published
v0.1.1
latest
Apr 1, 2026 6mo ago
These releases are tags only. The author does not attach a packaged zip, so there are no download counts to report.