Migrazione da Divi 4 a Divi 5: tutto quello che devi sapere

1. Cosa cambia tra Divi 4 e Divi 5

La differenza tra Divi 4 e Divi 5 non è paragonabile agli aggiornamenti incrementali a cui siamo abituati (Divi 4.14, 4.22, ecc.). Divi 5, sviluppato internamente sotto il nome in codice "Foundation", è una riscrittura completa del motore del builder.

In concreto, questo significa che cambiano tre cose fondamentali: il formato con cui i dati delle pagine vengono salvati nel database, il motore che trasforma quei dati in HTML visibile nel browser, e l'interfaccia con cui lavori nel Visual Builder.

Tutto il resto rimane compatibile: le licenze Elegant Themes non cambiano, i prezzi sono gli stessi, e l'aggiornamento a Divi 5 è gratuito per tutti gli utenti con un abbonamento attivo.

2. Architettura: da shortcode a JSON

Il problema degli shortcode

Divi 4, come molti page builder di prima generazione, salvava i layout come shortcode nella colonna post_content della tabella wp_posts. Ogni modulo era una sequenza di tag come [et_pb_section], [et_pb_row], [et_pb_text], incastrati uno dentro l'altro.

Questo approccio ha tre limiti strutturali:

• Costo computazionale. WordPress analizza gli shortcode con espressioni regolari (Regex) ricorsive. Su pagine complesse con centinaia di moduli, il parsing diventa pesante e rallenta il Time to First Byte (TTFB) lato server.
• Lock-in del contenuto. Disattivando il tema Divi, il contenuto diventa illeggibile: una sequenza di tag tra parentesi quadre. Migrare fuori da Divi 4 richiede strumenti di pulizia dedicati.
• Limitazioni di annidamento. Gli shortcode gestiscono male i livelli di nidificazione profondi: inserire un modulo complesso dentro un altro modulo era spesso impossibile senza workaround.

Il nuovo formato JSON

Divi 5 abbandona completamente gli shortcode. I layout vengono salvati come alberi di oggetti JSON strutturati. Ogni nodo rappresenta un modulo con le sue proprietà (attributi di design, contenuto, impostazioni responsive) definite come coppie chiave-valore.

I vantaggi tecnici sono immediati:

• Parsing rapido. Decodificare un oggetto JSON con json_decode() in PHP è incomparabilmente più veloce che eseguire migliaia di chiamate do_shortcode() via Regex.
• Stabilità dei dati. Il formato JSON è meno soggetto a errori di sintassi utente (un tag chiuso male che rompe l'intera pagina).
• Compatibilità Gutenberg. La struttura a blocchi di Divi 5 è allineata con l'architettura dell'editor nativo di WordPress, aprendo la strada alla conversione bidirezionale tra i due sistemi.

Confronto architetturale

Il motore React

L'interfaccia del Visual Builder è stata riscritta interamente in React. Nelle versioni precedenti, ogni interazione (cambiare un margine, modificare un colore) innescava spesso richieste AJAX al server tramite admin-ajax.php, generando latenza percepibile su connessioni lente o hosting condiviso.

Divi 5 mantiene lo stato della pagina nel browser. Il Virtual DOM aggiorna solo le parti dell'interfaccia che cambiano: spostare un cursore di padding si riflette a 60 frame per secondo senza alcuna chiamata di rete. Il server viene contattato solo per il salvataggio finale.

3. Performance e Core Web Vitals

I Core Web Vitals di Google sono oggi un fattore di ranking. L'architettura di Divi 5 è stata ottimizzata specificamente per queste metriche.

Largest Contentful Paint (LCP)

Il LCP misura il tempo di caricamento dell'elemento visivo principale nella viewport. Era il punto debole storico dei siti Divi: i punteggi tipici con Divi 4 oscillavano tra 3.5 e 4.5 secondi su mobile, a causa del parsing degli shortcode e dei CSS pesanti.

Con Divi 5, i benchmark scendono regolarmente sotto i 2.5 secondi, con risultati anche sotto 1.5 secondi su installazioni ottimizzate. Il meccanismo: il parsing JSON accelera il TTFB, e il Critical CSS inline permette al browser di disegnare il contenuto principale prima ancora di aver caricato il JavaScript.

Total Blocking Time (TBT)

Divi 5 modularizza il JavaScript e lo carica on-demand. Il sistema "Dynamic Assets" funziona in questo modo: ogni modulo dichiara le sue dipendenze. Se una pagina non contiene un modulo "Map", lo script dell'API Google Maps non viene mai caricato.

Su una pagina semplice (testo + immagine), il peso degli script può passare da oltre 300 KB (Divi 4) a meno di 50 KB (Divi 5). Nei test ufficiali, il TBT risulta spesso 0 secondi.

Benchmark comparativi (mobile)

4. Prerequisiti prima della migrazione

Prima di aggiornare, servono tre cose:

Requisiti tecnici

• PHP 7.4 o superiore (raccomandato PHP 8.1+)
• memory_limit di almeno 256 MB (512 MB raccomandato per siti complessi)
• WordPress 6.4 o superiore
• Licenza Elegant Themes attiva

5. Procedura di migrazione passo passo

L'aggiornamento avviene dalla dashboard di WordPress. Divi 5 include un Migrator automatico che gestisce la conversione.

6. Risoluzione degli errori comuni

Schermo bianco (WSOD) dopo l'aggiornamento

Causa: esaurimento della memoria PHP durante la conversione di una pagina molto complessa, o conflitto con un plugin di cache.

Soluzione:

1. Aumenta memory_limit a 512M o 1024M in wp-config.php
2. Disattiva tutti i plugin di cache prima della migrazione
3. Svuota manualmente la cartella wp-content/et-cache

// Aggiungi in wp-config.php
define('WP_MEMORY_LIMIT', '512M');

Errore critico sul frontend

Causa: un plugin di terze parti per Divi chiama una funzione PHP deprecata di Divi 4.

Soluzione:

1. Attiva il debug: imposta WP_DEBUG su true in wp-config.php
2. Identifica il plugin responsabile nel file debug.log
3. Disattiva il plugin via FTP (rinomina la cartella)
4. Usa il "Safe Mode" di Divi (Divi > Support Center) che disattiva temporaneamente le estensioni Divi di terze parti

Stili mancanti (Flash of Unstyled Content)

Causa: il CSS statico generato da Divi 5 non è accessibile o è corrotto.

Soluzione: vai su Divi > Opzioni Tema > Builder > Avanzato e clicca su "Clear Static CSS File Generation".

7. Modalità retrocompatibilità

Se un modulo di terze parti non è stato aggiornato per Divi 5, il sistema attiva automaticamente un modo ibrido.

• Funzionamento: Divi 5 carica il vecchio motore di rendering PHP solo per quel modulo specifico. Il resto della pagina usa la nuova architettura.
• Indicatore visivo: nel Visual Builder, questi moduli appaiono con un'etichetta "Legacy" o sono visualizzati in modo semplificato.
• Costo: il modo retrocompatibile preserva l'aspetto ma annulla i guadagni di performance per quella pagina. È una soluzione temporanea, non permanente.

Elegant Themes ha confermato il supporto per Divi 4 per almeno sei mesi dopo il rilascio ufficiale (26 febbraio 2026). Dopo quel periodo, gli aggiornamenti di sicurezza continueranno ma le nuove funzionalità saranno esclusive di Divi 5.

8. Compatibilità plugin di terze parti

La compatibilità dei plugin esterni è il fattore che determina i tempi della migrazione per la maggior parte degli utenti.

• Divi Pixel: compatibilità nativa. I moduli principali (Table of Contents, Flip Box) sono stati convertiti per Divi 5.
• Divi Supreme: versione Beta disponibile per Divi 5. Le versioni Pro richiedono un aggiornamento manuale delle chiavi di licenza.
• ACF (Advanced Custom Fields): l'integrazione nativa dei campi dinamici è migliorata in Divi 5. Gli shortcode ACF dentro i moduli Text ([acf field="name"]) funzionano ma sono meno performanti dell'icona "Contenuto Dinamico" del builder.
• WooCommerce: 17 moduli WooCommerce nativi disponibili in Divi 5. I plugin che modificano pesantemente il checkout o i loop dei prodotti richiedono verifiche approfondite.

Hook e filtri per sviluppatori

Per chi sviluppa estensioni Divi, i cambiamenti sono profondi:

• Deprecati: tutti i filtri basati su do_shortcode_tag, et_pb_all_text_modules, e quelli che manipolano shortcode via Regex. Questo codice non funziona più in Divi 5.
• Nuovi: Divi 5 introduce hook contestuali basati sul ciclo di vita del rendering React e PHP. I dati del modulo (l'oggetto props) possono essere filtrati prima del rendering, un approccio molto più pulito della manipolazione di stringhe HTML.
• Moduli custom: la dichiarazione avviene tramite file module.json e conversion-outline.json (per la migrazione da Divi 4). Il boilerplate PHP è drasticamente ridotto.

9. Ottimizzazione post-migrazione

Una volta che la migrazione è stabile (dopo qualche settimana di monitoraggio), puoi ottimizzare.

Pulizia del database

Il Migrator conserva gli shortcode originali come fallback. Quando sei certo che il rollback non ti serve più, puoi liberare spazio:

-- Rimuove i vecchi shortcode di backup (SOLO dopo validazione completa)
DELETE FROM wp_postmeta WHERE meta_key LIKE '_et_pb_old_content%';

Refactoring consigliato

• Sostituisci gli shortcode ACF nei moduli Text con l'icona "Contenuto Dinamico" nativa di Divi 5
• Converti i CSS custom inline nei Preset globali di Divi 5
• Utilizza le variabili di design (colori, font, spaziature) al posto dei valori statici
• Attiva il markup semantico HTML (<header>, <main>, <nav>, <footer>) sui tuoi elementi di layout per migliorare SEO e accessibilità

10. Quando migrare: tabella decisionale

Il momento giusto per migrare dipende dalla complessità del tuo sito.

Conclusione

La migrazione a Divi 5 non è un semplice aggiornamento di plugin: è un cambio di paradigma architetturale. I vantaggi in termini di performance, esperienza di editing e compatibilità con l'ecosistema WordPress moderno sono reali e misurabili.

Il consiglio è semplice: non avere fretta ma non rimandare troppo. Testa su staging, verifica i plugin critici, e quando sei pronto, fai il salto. Il supporto per Divi 4 ha una scadenza, e prima inizi a sfruttare i Preset, le variabili globali e la nuova architettura, prima ne vedrai i benefici sul tuo lavoro quotidiano.

Per una panoramica completa di Divi 5, torna alla pagina principale. Per i dettagli sui piani e le licenze, consulta la pagina prezzi di Divi 5. Se stai valutando alternative, leggi i nostri confronti: Divi vs Elementor, Divi vs Bricks e Divi vs Gutenberg.