📖 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
- Download divi-import-export-theme.zip
- Go to Plugins → Add New → Upload Plugin
- Install and activate
- 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:
- 🎨 Child Theme — Must be first (theme needs to be active)
- 🔌 Plugins — Before content (plugins may register custom post types)
- 📚 Divi Library — Independent
- ⚙️ Customizer — Independent
- 🖼️ Media — Builds an old→new ID map
- 📝 Content — Uses the media ID map for thumbnails and inline images
- 🧭 Menus — Uses content ID map for page/post references
- 🏗️ Theme Builder — Uses content ID map for layout references
- 🧩 Widgets — Independent
- ⚙️ 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.
