Copy fields from one Voxel post type to another. This is useful when you want to reuse field configurations across multiple post types without manually recreating them.
Key Features
- Select source and destination post types
- Choose specific fields to copy via checkbox list
- Required key suffix to prevent naming conflicts
- Automatic singleton field detection with warnings
- Handles nested repeater fields
How to Use
- Navigate to Voxel Toolkit > Tools
- Find the Duplicate Post Fields section
- Select the Source Post Type (where fields exist)
- Select the Destination Post Type (where to copy fields)
- Check the fields you want to copy
- Enter a Key Suffix (required)
- Click Duplicate Fields
Key Suffix
When duplicating fields, you must provide a key suffix that will be appended to all copied field keys. This prevents naming conflicts with existing fields.
Example
If you copy a field with key description and use suffix _copy:
- Original key:
description
- New key:
description_copy
Tip: Use descriptive suffixes like _events or _products to indicate where the field came from.
Singleton Field Warnings
Some Voxel fields are “singletons” – fields that should only exist once per post type. These include:
- Title
- Description
- Location
- Featured Image
- Timezone
When you select a singleton field, a warning will appear. If the destination post type already has a field of that type, the duplicate may not work as expected.
Repeater Fields
Repeater fields are fully supported. When you duplicate a repeater field:
- All nested sub-fields are copied
- The suffix is applied to the parent field key
- Sub-field structure is preserved
- Validation rules are maintained
Use Cases
Standardizing Fields
Copy a set of common fields (contact info, social links) to multiple post types for consistency.
Creating Variations
Duplicate a complex product field configuration to create a similar but slightly different post type.
Testing Changes
Copy fields to a test post type before making changes, so you can experiment safely.
Migration
When restructuring your site, copy field configurations to new post types before migrating data.
Troubleshooting
Fields Not Appearing After Duplication
- Refresh the destination post type editor
- Check if the field key already existed (would be skipped)
- Verify you selected the correct destination post type
Duplicate Button Disabled
- Select both source and destination post types
- Select at least one field to copy
- Enter a key suffix
Singleton Field Errors
- Remove the existing singleton field from the destination first
- Or skip duplicating singleton fields and configure them manually
Requirements
- Voxel Theme (active)
- Voxel Toolkit plugin (enabled)
- Administrator access to WordPress
