Troubleshooting
Find solutions to common Divi Handoff issues. This section covers the most frequently encountered problems and their solutions.
Common Issues
Display Problems
- Layouts Not Displaying - Flexible Content layouts don't appear on the page
- Fields Not Showing - Module displays but field data is empty or missing
Technical Issues
- Compatibility Issues - Plugin conflicts, version requirements, and caching problems
Quick Diagnosis
Before diving into specific issues, check these common causes:
1. Divi Handoff Not Enabled
The most common issue is forgetting to enable Divi Handoff on the page:
- Edit the page in WordPress
- Look for the Divi Handoff Settings meta box
- Enable Divi Handoff on this page
2. No Layout Mapping
Ensure your Divi Handoff Layout is mapped to the correct SCF/ACF layout:
- Go to Divi Handoff Layouts in admin
- Edit your layout
- Check the Layout Mapping meta box
- Select the SCF/ACF Flexible Content layout
3. Missing Dependencies
Divi Handoff requires:
- Divi 5 (Divi Theme) - Divi 4 is not supported
- SCF (Secure Custom Fields) OR ACF Pro - Free ACF is not supported
- WordPress 6.4 or higher
Still Need Help?
If you can't find a solution:
- Check the FAQ for common questions
- Review the Developer Reference for technical details
- Contact Divi Engine Support
When contacting support, please include:
- WordPress version
- Divi version
- SCF or ACF Pro version
- Plugin version (1.0.0)
- Steps to reproduce the issue
- Screenshots if applicable
What's Next
- Layouts Not Displaying - Fix layout display issues
- Fields Not Showing - Resolve missing field data
- Compatibility Issues - Solve plugin conflicts