What is Custom Field Suite plugin?
Custom Field Suite is a free WordPress plugin for adding custom fields to posts, pages, and custom post types. It provides field groups with various field types – text, textarea, date, relationship, loop (repeater), and more – that appear in the post editor and store data as post metadata.
Custom Field Suite was a popular lightweight alternative to Advanced Custom Fields before ACF became the dominant standard. It remains free and functional but development has slowed significantly. For new projects, ACF Free or Meta Box are better-supported alternatives. Custom Field Suite is most relevant for maintaining existing sites that already use it rather than for new development.
Need Help With Custom Field Suite Setup, Troubleshooting, or Customization?
Need help with Custom Field Suite? Whether you are dealing with errors, broken functionality, styling problems, plugin conflicts, or advanced customization, we can help you fix the issue and get the plugin working properly on your WordPress site.
Get Custom Field Suite Expert HelpKey Features
- Custom field groups
- Multiple field types (text textarea date relationship loop)
- Post type assignment rules
- Template functions for displaying fields
- Relationship fields between posts
Pros & Cons
Pros
- Free with no premium tier
- Lightweight with minimal overhead
- Simple interface
Cons
- Development largely inactive since 2023
- Smaller community than ACF
Free vs Premium
Custom Field Suite is completely free with no premium version. All features are available without payment.
Common Problems & Fixes
Custom Field Suite fields are not displaying on the frontend. How do I show them?
Use the CFS::get() function in your theme template: get(“field_name”); ?>. Fields are not displayed automatically – you must add template code. Verify the field name matches exactly what is configured in the field group, including case.
Custom Field Suite is conflicting with my theme or another plugin. How do I debug this?
CFS conflicts are usually caused by function name collisions with older code. Deactivate CFS and test if the conflict resolves. If so, check for other plugins or theme functions named CFS or using similar prefixes. Since CFS is largely unmaintained, consider migrating to ACF for long-term compatibility.
My Custom Field Suite data is not saving. What should I check?
Check for nonce verification failures in browser DevTools network tab – a 403 response on save indicates a security token issue. Verify no caching plugin is interfering with the post save process. Check PHP error logs for fatal errors during the save action.
Customization & Developer Notes
How do I create a repeating field group with Custom Field Suite?
Use the Loop field type in CFS – this is the equivalent of ACF Repeater. Add a Loop field to your field group, then add sub-fields within the loop. In templates, iterate through loop values with: get(“loop_name”) as $row): echo $row[“sub_field_name”]; endforeach; ?>
Should I migrate from Custom Field Suite to ACF?
For new projects, yes – ACF has active development, extensive documentation, a large community, and broader ecosystem support. For existing sites using CFS, migration requires: exporting field configurations, recreating them in ACF, migrating stored post meta (the data is stored as standard WordPress post meta and can be re-mapped), and updating template code from CFS()->get() to get_field(). Migration effort is proportional to how extensively CFS is used.
Frequently Asked Questions
Is Custom Field Suite still maintained?
Custom Field Suite has had minimal updates since 2023. It still works on current WordPress versions but development is largely inactive. For production sites, ACF Free or Meta Box are better choices with active maintenance teams.
How does Custom Field Suite compare to Advanced Custom Fields?
ACF has significantly more field types, active development, extensive documentation, Gutenberg block builder, and a large community. CFS has a simpler interface and the Loop field (repeater equivalent) free of charge – ACF Free lacks a repeater. For new projects, ACF is the clear choice. CFS is only relevant for maintaining existing implementations.
Can Custom Field Suite data be migrated to ACF?
Yes – both store data as WordPress post meta using standard get_post_meta() functions. The field names and meta keys need to match or be remapped. Export your CFS field configurations, recreate equivalent ACF field groups with matching field names (or use ACF field name mapping), and the existing data becomes accessible through ACF template functions.
Does Custom Field Suite work with Gutenberg?
Custom Field Suite displays its fields in the classic meta box area of the Gutenberg editor. It is not a Gutenberg-native plugin and does not create Gutenberg blocks from custom fields. ACF (with its Blocks feature) or Meta Box (with MB Blocks) offer Gutenberg-native custom field experiences.