📖 Divi Packager — Documentation

🚀 Getting Started

📋 Requirements

  • 🌐 WordPress 6.0+
  • 💜 Divi 5 (Theme or Builder Plugin)
  • ⚡ PHP 7.4+ with ZipArchive extension
  • 💾 256MB PHP memory limit recommended
  • 🎨 Active Divi 5 child theme on the export site

📥 Installation

  1. Download divi-import-export-theme.zip
  2. Go to Plugins → Add New → Upload Plugin
  3. Install and activate
  4. A new 🔽 Divi Export menu appears in the sidebar

📤 Exporting Your Theme (Seller Guide)

🎯 Before You Export

Make sure your demo site is fully ready:

  • ✅ Divi 5 child theme active
  • ✅ All pages, posts, and content created
  • ✅ Theme Builder templates assigned
  • ✅ Customizer settings configured
  • ✅ Menus set up and assigned
  • ✅ Required plugins installed and active

📝 Step by Step

1️⃣ Go to WordPress Admin → Divi Export

2️⃣ Fill in Package Name (plugin slug, no spaces) and Display Name (human-readable)

3️⃣ Check the content types to include:

  • 🎨 Child Theme — All theme files
  • 🔌 Plugins — Pick which active plugins to bundle (expand to see the list)
  • 📚 Divi Library — All saved layouts
  • ⚙️ Customizer Settings — Theme Mods + Divi Theme Options
  • 🖼️ Media Files — All images and media
  • 📝 Content — Pages, posts, CPTs (expand to pick post types)
  • 🧭 Navigation Menus — Menus, items, and locations
  • 🏗️ Theme Builder — Templates, layouts, presets, assignments
  • 🧩 Widgets — Widget areas and settings

4️⃣ Set the Homepage and Posts Page titles

5️⃣ Click 🚀 Generate Package and wait for completion

6️⃣ Click 📥 Download Package

💡 The file is saved as {package-name}-installer.zip in wp-content/uploads/

📥 Importing a Theme (Buyer Guide)

🎯 Before You Import

  • ✅ Fresh WordPress install (recommended)
  • ✅ Divi 5 installed and active
  • ✅ Admin access

⚠️ Importing on a site with existing content may create duplicates.

📝 Step by Step

1️⃣ Go to Plugins → Add New → Upload Plugin, install the {theme-name}-installer.zip

2️⃣ Activate — you'll be redirected to the installer page automatically

3️⃣ Click ▶️ Start Import

4️⃣ Watch each step complete automatically:

  • 🎨 Install Child Theme
  • 🔌 Install Plugins
  • 📚 Import Divi Library
  • ⚙️ Import Customizer Settings
  • 🖼️ Import Media Files
  • 📝 Import Content
  • 🧭 Import Navigation Menus
  • 🏗️ Import Theme Builder
  • 🧩 Import Widgets
  • ⚙️ Configure Settings (homepage, blog page, permalinks)

Each step shows ✅ on success or ⚠️ on error. The import continues even if one step fails.

5️⃣ Click 🌐 Visit Site to see the result!

💡 Once done, you can deactivate and delete the installer plugin.

⚙️ How It Works Under the Hood

🔄 Import Order

The order matters because later steps depend on earlier ones:

  1. 🎨 Child Theme — Must be first (theme needs to be active)
  2. 🔌 Plugins — Before content (plugins may register custom post types)
  3. 📚 Divi Library — Independent
  4. ⚙️ Customizer — Independent
  5. 🖼️ Media — Builds an old→new ID map
  6. 📝 Content — Uses the media ID map for thumbnails and inline images
  7. 🧭 Menus — Uses content ID map for page/post references
  8. 🏗️ Theme Builder — Uses content ID map for layout references
  9. 🧩 Widgets — Independent
  10. ⚙️ Settings — Must be last (needs pages to exist)

🆔 Smart ID Remapping

All IDs are automatically remapped during import:

  • 🖼️ Media old ID → new ID
  • 📝 Content _thumbnail_id and inline <img> URLs → remapped via media map
  • 🧭 Menu items → page/post references remapped via content map
  • 🏗️ Theme Builder → layout references remapped
  • 🔗 All URLs → old site URL replaced with new site URL

🔧 Troubleshooting

❌ "Could not create temporary directory"

→ Check that wp-content/uploads/ is writable (permissions 755 or 775)

❌ "ZipArchive extension is not available"

→ Ask your host to enable the PHP zip extension

❌ Export times out or blank page

→ Increase max_execution_time to 300 and memory_limit to 256M in php.ini

❌ AJAX returns 0

→ Deactivate other plugins to check for conflicts. Check wp-content/debug.log

❌ Theme Builder templates not showing

→ Clear Divi cache: Divi → Theme Options → Builder → Advanced → Static CSS → Clear

❌ Plugin not activating

→ Check the error message. Try activating manually from Plugins page

❓ FAQ

🤔 Does it work with Divi 4?

No, it's built for Divi 5 only. Theme Builder and module presets use Divi 5-specific APIs.

🤔 Can the buyer re-run the import?

Yes, but it may create duplicates. A warning is shown. Best on a fresh install.

🤔 What if a plugin is already installed?

It won't be overwritten — extraction is skipped, but it's still activated.

🤔 Can I include premium plugins?

Yes, any active plugin can be bundled. Make sure you have redistribution rights (GPL).

🤔 Is there a size limit?

No hard limit, but very large sites may hit PHP limits. The plugin raises limits automatically during export/import.

🤔 Can I exclude specific pages?

Not individually. You can deselect entire post types, but not individual posts.

🤔 Does it handle WooCommerce?

Yes! Products are a custom post type and appear in the post type selection.

🤔 What about custom database tables?

Only standard WordPress data is exported. Custom tables from third-party plugins are not included.