Skip to main content

Installation

This guide walks you through installing and activating Divi Handoff on your WordPress site.

Prerequisites and Versions​

Before installing Divi Handoff, ensure your site meets these requirements:

RequirementMinimum VersionNotes
WordPress6.4 or higherRequired for compatibility
Divi Theme5.x (Divi 5)Divi 4 is not supported
PHP7.4 or higherStandard WordPress requirement
SCF or ACF ProLatestSee note below

Custom Fields Plugin Requirement​

Divi Handoff requires one of the following custom fields plugins:

Free ACF Not Supported

The free version of Advanced Custom Fields does not include Flexible Content and is not compatible with Divi Handoff. Use SCF (free) or upgrade to ACF Pro.

Download and Install​

Step 1: Download the Plugin​

  1. Log in to your Divi Engine account
  2. Navigate to Downloads
  3. Download the latest version of Divi Handoff

Step 2: Install the Plugin​

  1. In your WordPress admin, go to Plugins → Add New
  2. Click Upload Plugin
  3. Click Choose File and select the downloaded divi-handoff.zip file
  4. Click Install Now
  5. Wait for the installation to complete

Step 3: Activate the Plugin​

  1. Click Activate Plugin
  2. If SCF or ACF Pro is not installed, you'll see an admin notice prompting you to install one
  3. If Divi Theme is not active, you'll see an admin notice to activate it

License Activation​

After activation, activate your license to receive updates and support:

  1. Go to Divi Engine → Divi Handoff in the WordPress admin menu
  2. Navigate to the License tab
  3. Enter your license key from your Divi Engine account
  4. Click Activate License
  5. Verify the license status shows Active
Finding Your License Key

Your license key is available in your Divi Engine account under License Keys. Each purchase includes a unique license key.

Verify Installation​

After successful installation and activation, verify everything is working:

Check 1: Admin Menu​

Look for Divi Handoff Layouts in the WordPress admin menu. This is where you'll create layouts that render your Flexible Content.

Check 2: Settings Page​

Navigate to Divi Engine → Divi Handoff. You should see the settings page with tabs for:

  • General — Page display settings
  • User Permissions — Role-based access control
  • Sidebar — Sidebar position and widgets
  • Layout Injection — Inject Divi layouts at specific positions
  • Help & Demo — Documentation link and demo content import

Check 3: No Admin Notices​

Ensure there are no error notices about missing dependencies. If you see notices:

  • "Divi Handoff requires Secure Custom Fields or Advanced Custom Fields Pro to be installed and activated. You can download SCF or ACF Pro here." — Install and activate SCF or ACF Pro (the notice includes links to download)
  • "Divi Handoff requires Divi Theme to be installed and active" — Activate the Divi Theme

Quick Setup with Demo Content​

Get started quickly by importing demo content:

  1. Go to Divi Engine → Divi Handoff
  2. Click the Help & Demo tab
  3. Click Import Demo Content

The demo imports:

  • 1 SCF/ACF Field Group — A page field group with Flexible Content
  • 8 Divi Handoff Layouts — Pre-built layout templates
  • 1 Demo Page — A page with sample content to explore

This provides a working example to help you understand how Divi Handoff connects Flexible Content with Divi layouts.

Next Steps​

After installation, you're ready to:

  1. Explore the demo — View the imported demo page to see Divi Handoff in action
  2. Create field groups — Set up SCF or ACF Pro Flexible Content for your content structure
  3. Build layouts — Create Divi Handoff Layouts to render your Flexible Content visually

Troubleshooting Installation​

Plugin Won't Activate​

Cause: Missing dependencies (Divi 5 or SCF/ACF Pro)

Solution:

  1. Ensure Divi Theme (version 5.x) is installed and active
  2. Install and activate SCF or ACF Pro
  3. Try activating Divi Handoff again

License Won't Activate​

Cause: Invalid or already-used license key

Solution:

  1. Verify the license key is copied correctly (no extra spaces)
  2. Check your Divi Engine account for the correct license key
  3. Deactivate the license on other sites if you've reached the activation limit

Divi Handoff Layouts Menu Missing​

Cause: Plugin not fully activated or dependency missing

Solution:

  1. Deactivate and reactivate the plugin
  2. Check for PHP errors in Tools → Site Health
  3. Verify all dependencies are installed and active

What's Next​