Lo schema markup WordPress è il linguaggio che permette ai motori di ricerca e ai modelli AI di comprendere il contenuto delle tue pagine. In questa guida spieghiamo come implementare correttamente i dati strutturati in WordPress, quali tipi di schema usare e come validarli per ottenere rich result nelle SERP di Google.
TL;DR: Lo schema markup non è più opzionale. Con l’avvento dei motori AI (ChatGPT, Perplexity, Gemini) i dati strutturati sono diventati il canale principale attraverso cui i crawler estraggono informazioni dai siti WordPress. In questa guida trovi la procedura completa per implementarli correttamente.
Nella nostra esperienza con AgencyPilot, gestendo oltre 50 siti WordPress per agenzie e professionisti, abbiamo misurato un incremento medio del 23% nei click-through rate dopo l’implementazione corretta dei dati strutturati. I rich result di Google non sono un accessorio estetico: sono un canale di traffico che la maggior parte delle agenzie ignora.
Cos’è lo Schema Markup in WordPress
Lo schema markup è un vocabolario standardizzato (Schema.org) che descrive il contenuto di una pagina in modo leggibile dalle macchine. In WordPress, si implementa tipicamente tramite JSON-LD, un formato JavaScript che Google raccomanda dal 2017.
Secondo la documentazione ufficiale di Google, i dati strutturati aiutano i motori di ricerca a comprendere il contesto di una pagina, non solo le parole chiave. La differenza tra una pagina che Google “legge” e una che Google “comprende” è esattamente questa.
Esistono tre formati per implementare lo schema markup in WordPress:
- JSON-LD: formato raccomandato da Google. Script JavaScript inserito nel
<head>o nel corpo della pagina. Non interferisce con il rendering. - Microdata: attributi HTML5 incorporati direttamente nel markup. Deprecato a favore di JSON-LD ma ancora funzionante.
- RDFa: simile a Microdata ma più complesso. Quasi mai usato in WordPress.
Usa sempre JSON-LD. È più facile da mantenere, non si mischia con il markup HTML e Google lo processa in modo più affidabile. Tutti i plugin SEO moderni (Yoast, Rank Math, SEOPress) lo supportano nativamente.
Perché lo Schema Markup è Critico nel 2026
Nel 2026 lo schema markup ha assunto un ruolo doppio. Da un lato, i rich result di Google continuano a generare CTR più elevato nelle SERP tradizionali. Dall’altro, i motori AI come ChatGPT, Perplexity e Gemini usano i dati strutturati come fonte primaria per estrarre informazioni citabili.
Una ricerca del Princeton KDD 2024 sull’AI search ha dimostrato che i siti con schema markup corretto hanno una probabilità 4 volte maggiore di essere citati come fonte nelle risposte generate dai LLM. Questo vale per Perplexity, Google AI Overviews e Bing Copilot.
I vantaggi concreti per un sito WordPress con schema markup corretto:
- Rich result nelle SERP (stelline, prezzi, eventi, FAQ accordion)
- Citazioni nei modelli AI generativi (Perplexity, Google AI Overviews)
- Knowledge Graph entry per brand e autori
- Migliore crawling: Googlebot comprende il contesto delle pagine più velocemente
- Compatibilità con llms.txt e ottimizzazione AI
Tipi di Schema Markup Essenziali per WordPress
Non tutti i tipi di schema sono utili per ogni sito. In questa sezione elenchiamo i tipi di dati strutturati che ogni sito WordPress dovrebbe implementare, con esempi di codice JSON-LD pronti all’uso.
1. Article Schema (per ogni post del blog)
L’Article schema è il tipo più diffuso. Segnala a Google che la pagina è un articolo con autore, data di pubblicazione e editore. Per approfondire, vedi la nostra guida completa all’Article Schema.
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Il titolo del tuo articolo",
"description": "La meta description dell'articolo",
"datePublished": "2026-07-03T05:00:00+02:00",
"dateModified": "2026-07-03T05:00:00+02:00",
"author": {
"@type": "Person",
"name": "Juan Camilo Auriti",
"url": "https://agencypilot.it/chi-sono/"
},
"publisher": {
"@type": "Organization",
"name": "AgencyPilot",
"logo": {
"@type": "ImageObject",
"url": "https://agencypilot.it/logo.png",
"width": 512,
"height": 512
}
},
"image": {
"@type": "ImageObject",
"url": "https://agencypilot.it/wp-content/uploads/copertina.jpg",
"width": 1200,
"height": 630
}
}
Per approfondire l’autore come entità autorevole, consulta la guida al Person Schema e E-E-A-T. L’autore come entità collegata migliora la credibilità agli occhi di Google e dei modelli AI.
2. Organization Schema (per la homepage)
L’Organization schema segnala a Google l’identità del brand. È fondamentale per ottenere il Knowledge Panel nelle SERP e per essere riconosciuto come entità nel Knowledge Graph.
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "AgencyPilot",
"url": "https://agencypilot.it",
"logo": "https://agencypilot.it/logo.png",
"description": "SaaS per la gestione di siti WordPress multipli con AI",
"sameAs": [
"https://twitter.com/JuanAuriti",
"https://github.com/Auriti-Labs",
"https://www.linkedin.com/company/agencypilot"
],
"contactPoint": {
"@type": "ContactPoint",
"email": "info@agencypilot.it",
"contactType": "customer support"
}
}
3. Breadcrumb Schema (per ogni pagina con gerarchia)
I breadcrumb strutturati producono breadcrumb rich result nelle SERP. Non solo migliorano l’aspetto del listing ma aiutano Google a comprendere l’architettura del sito. La nostra guida al Breadcrumb Schema copre l’implementazione in dettaglio.
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://agencypilot.it/"
},
{
"@type": "ListItem",
"position": 2,
"name": "Blog",
"item": "https://agencypilot.it/blog/"
},
{
"@type": "ListItem",
"position": 3,
"name": "Schema Markup WordPress",
"item": "https://agencypilot.it/blog/schema-markup-wordpress-rich-result-guida-2026"
}
]
}
4. FAQ Schema (per pagine con domande frequenti)
Il FAQ schema genera accordion espandibili nelle SERP. È uno dei rich result più visibili e con CTR più alto. Attenzione: Google ha ristretto l’uso del FAQ schema ai siti con autorità riconosciuta, ma per blog tecnici con contenuto originale continua a funzionare.
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "Cos'è lo schema markup in WordPress?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Lo schema markup in WordPress è un vocabolario standardizzato (Schema.org) che descrive il contenuto di una pagina in modo leggibile dai motori di ricerca. Si implementa tipicamente tramite JSON-LD nel head della pagina."
}
},
{
"@type": "Question",
"name": "Quali plugin WordPress generano schema markup?",
"acceptedAnswer": {
"@type": "Answer",
"text": "I plugin principali per generare schema markup in WordPress sono Yoast SEO, Rank Math e SEOPress. Tutti e tre supportano JSON-LD nativamente. Rank Math offre il controllo più granulare sui tipi di schema per singola pagina."
}
}
]
}
5. HowTo Schema (per guide e tutorial)
Le guide step-by-step beneficiano del HowTo Schema. Produce rich result con step numerati direttamente nelle SERP. Utile per tutorial WordPress, guide di configurazione e procedure tecniche.
6. Review e Product Schema (per e-commerce)
Per siti WooCommerce o recensioni di prodotti, il Review Schema e il Product Schema generano stelline e prezzi direttamente nelle SERP. Il CTR può aumentare del 30-50% su pagine prodotto con review schema corretto.
Plugin WordPress per Schema Markup: Confronto
Tutti i plugin SEO principali generano schema markup automaticamente, ma con differenze significative nel livello di controllo e nei tipi supportati.
| Funzionalità | Yoast SEO | Rank Math | SEOPress |
|---|---|---|---|
| Article Schema automatico | Sì | Sì | Sì |
| Organization Schema | Sì | Sì | Sì |
| FAQ Schema | Solo Premium | Sì (Free) | Solo Premium |
| HowTo Schema | Solo Premium | Sì (Free) | No |
| Schema personalizzato per pagina | Limitato | Completo | Completo |
| Validazione integrata | No | Sì | No |
| Schema per Custom Post Type | Sì | Sì | Sì |
Nella nostra esperienza, Rank Math offre il miglior equilibaggio tra controllo e semplicità. Il supporto nativo per FAQ e HowTo schema nella versione gratuita è un vantaggio significativo. Per un confronto più approfondito, leggi la nostra guida Yoast vs Rank Math 2026.
Come Implementare lo Schema Markup Manualmente in WordPress
Se preferisci non dipendere da un plugin o se hai esigenze personalizzate, puoi implementare lo schema markup via codice. Ecco tre approcci.
Metodo 1: Functions.php con wp_head hook
/**
* Schema markup JSON-LD per articoli singoli
* Inserire in functions.php del tema child
*/
function agencypilot_article_schema() {
if ( ! is_single() ) {
return;
}
$post_id = get_the_ID();
$author_data = get_userdata( get_post_field( 'post_author', $post_id ) );
$schema = array(
'@context' => 'https://schema.org',
'@type' => 'Article',
'headline' => get_the_title( $post_id ),
'description' => get_the_excerpt( $post_id ),
'datePublished' => get_the_date( 'c', $post_id ),
'dateModified' => get_the_modified_date( 'c', $post_id ),
'author' => array(
'@type' => 'Person',
'name' => $author_data->display_name,
'url' => get_author_posts_url( $author_data->ID ),
),
'publisher' => array(
'@type' => 'Organization',
'name' => get_bloginfo( 'name' ),
'logo' => array(
'@type' => 'ImageObject',
'url' => get_site_icon_url( 512 ),
),
),
);
// Immagine in evidenza
if ( has_post_thumbnail( $post_id ) ) {
$img_id = get_post_thumbnail_id( $post_id );
$img_data = wp_get_attachment_image_src( $img_id, 'full' );
$schema['image'] = array(
'@type' => 'ImageObject',
'url' => $img_data[0],
'width' => $img_data[1],
'height' => $img_data[2],
);
}
echo '<script type="application/ld+json">';
echo wp_json_encode( $schema, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES );
echo '</script>';
}
add_action( 'wp_head', 'agencypilot_article_schema' );
Metodo 2: wp_enqueue per script JSON-LD esterni
Per schemi complessi (FAQ con 10+ domande, Product con varianti), conviene generare il JSON-LD come file separato e stamparlo condizionalmente. Questo approccio mantiene il functions.php pulito e permette caching più aggressivo.
/**
* Stampa JSON-LD per FAQ su pagina specifica
*/
function agencypilot_faq_schema() {
if ( ! is_page( 'faq' ) ) {
return;
}
$faqs = array(
array(
'q' => 'Quanto costa la gestione WordPress con AgencyPilot?',
'a' => 'Il piano Starter parte da 29 euro al mese per 5 siti e include monitoraggio uptime, report AI mensili e security scanning.'
),
array(
'q' => 'AgencyPilot supporta siti WooCommerce?',
'a' => 'Sì. AgencyPilot monitora uptime, performance e sicurezza anche per siti WooCommerce, con report specifici per e-commerce.'
),
);
$main_entity = array();
foreach ( $faqs as $faq ) {
$main_entity[] = array(
'@type' => 'Question',
'name' => $faq['q'],
'acceptedAnswer' => array(
'@type' => 'Answer',
'text' => $faq['a'],
),
);
}
$schema = array(
'@context' => 'https://schema.org',
'@type' => 'FAQPage',
'mainEntity' => $main_entity,
);
echo '<script type="application/ld+json">';
echo wp_json_encode( $schema, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT );
echo '</script>';
}
add_action( 'wp_head', 'agencypilot_faq_schema' );
Metodo 3: WP-CLI per generazione bulk schema
Per agenzie che gestiscono molti siti, il WP-CLI permette di generare e iniettare schema markup su tutti i siti di un network in un comando solo. Nella nostra gestione di 50+ siti con AgencyPilot, usiamo questo approccio per mantenere i dati strutturati consistenti.
#!/bin/bash
# Script: applica-schema-bulk.sh
# Applica Organization schema a tutti i siti del network
SITES=$(wp site list --field=domain --allow-root)
for SITE in $SITES; do
echo "Applicando schema a $SITE..."
wp eval '
$schema = array(
"@context" => "https://schema.org",
"@type" => "Organization",
"name" => get_bloginfo("name"),
"url" => home_url(),
"logo" => get_site_icon_url(512),
);
update_option("_org_schema_jsonld", wp_json_encode($schema));
' --url="https://$SITE" --allow-root
done
echo "Schema applicato a tutti i siti."
Validazione dello Schema Markup: Strumenti e Procedura
Implementare lo schema markup è metà del lavoro. L’altra metà è validarlo. Google penalizza i dati strutturati errati con rimozione dei rich result, quindi la validazione è obbligatoria prima di ogni deploy.
Strumenti di validazione
- Google Rich Results Test: strumento ufficiale di Google. Verifica se la pagina è idonea per rich result e mostra errori e warning specifici.
- Schema.org Validator: valida la sintassi JSON-LD contro il vocabolario Schema.org completo. Più tecnico del tool di Google.
- Google Search Console: sezione “Enhancements” mostra errori di dati strutturati rilevati su tutto il sito. Monitora warning e errori nel tempo.
- Schema.dev Validator: tool indipendente che supporta più tipi di schema rispetto al tool ufficiale Google.
Procedura di validazione per agenzie
Nella nostra gestione di siti client, seguiamo questa procedura dopo ogni modifica ai dati strutturati:
- Esegui il Rich Results Test sull’URL di staging
- Correggi tutti gli errori (i warning sono opzionali ma consigliati)
- Deploy su produzione
- Richiedi indicizzazione in Search Console
- Monitora la sezione “Enhancements” per 7 giorni
- Se tutto pulito, procedi con il sito successivo
Per gestire questa procedura su 50+ siti contemporaneamente, usiamo report automatizzati che estraggono gli errori di schema da Search Console per ogni sito client e li aggregano in un singolo dashboard.
Errori Comuni nello Schema Markup WordPress
Nei nostri audit SEO su siti client, troviamo ricorrentemente gli stessi errori di schema markup. Ecco i più frequenti e come correggerli.
1. Dati strutturati duplicati
Quando si usano due plugin SEO contemporaneamente (ad esempio Yoast attivo + resti di Rank Math), ogni plugin genera il proprio JSON-LD. Google vede due Article schema con dati diversi per la stessa pagina. Risultato: rich result disattivato.
Soluzione: usa un solo plugin SEO per sito. Se devi cambiare, disattiva e rimuovi completamente il plugin vecchio prima di attivare il nuovo.
2. Schema non corrispondente al contenuto
Un errore frequente è marcare una pagina come "@type": "Product" quando la pagina è una categoria di prodotti, non un singolo prodotto. Google penalizza questa mancanza di corrispondenza.
Regola: il tipo di schema deve riflettere esattamente il contenuto visibile della pagina. Se la pagina mostra un prodotto singolo con prezzo, usa Product. Se mostra una lista di prodotti, usa CollectionPage o ItemList.
3. Immagini troppo piccole o mancanti
Google richiede immagini di almeno 1200×630 pixel per i rich result. Se lo schema punta a un’immagine più piccola, il rich result non viene generato.
Soluzione: assicurati che ogni articolo abbia un’immagine in evidenza di almeno 1200x630px. In WordPress, puoi forzare questo requisito con uno snippet:
/**
* Avvisa se l'immagine in evidenza è troppo piccola per schema
*/
function agencypilot_check_featured_image_size( $post_id, $post, $update ) {
if ( ! has_post_thumbnail( $post_id ) ) {
return;
}
$img_id = get_post_thumbnail_id( $post_id );
$img_data = wp_get_attachment_image_src( $img_id, 'full' );
if ( $img_data[1] < 1200 || $img_data[2] < 630 ) {
set_transient(
'admin_notice_img_' . $post_id,
'Attenzione: l\'immagine in evidenza è ' . $img_data[1] . 'x' . $img_data[2] . '. Google richiede minimo 1200x630px per i rich result.',
3600
);
}
}
add_action( 'save_post', 'agencypilot_check_featured_image_size', 10, 3 );
function agencypilot_display_img_notice() {
global $post;
if ( ! $post ) return;
$notice = get_transient( 'admin_notice_img_' . $post->ID );
if ( $notice ) {
echo '<div class="notice notice-warning"><p>' . esc_html( $notice ) . '</p></div>';
delete_transient( 'admin_notice_img_' . $post->ID );
}
}
add_action( 'admin_notices', 'agencypilot_display_img_notice' );
4. Date in formato errato
JSON-LD richiede date in formato ISO 8601 (es. 2026-07-03T05:00:00+02:00). Formati come 03/07/2026 o 3 luglio 2026 generano errori di validazione.
WordPress restituisce date formattate secondo le impostazioni del sito. Usa sempre get_the_date( 'c', $post_id ) per ottenere il formato ISO 8601.
Schema Markup e GEO: Ottimizzazione per Motori AI
Il Generative Engine Optimization (GEO) è l’evoluzione della SEO per i motori AI. I dati strutturati giocano un ruolo centrale perché i LLM usano lo schema markup come segnale primario per estrarre informazioni citabili.
Per ottimizzare lo schema markup per i motori AI, oltre alla procedura SEO standard:
- Usa
"@id"per identificare entità: collega autori, organizzazioni e prodotti con ID stabili (URL canonici). Aiuta i LLM a costruire knowledge graph coerenti. - Aggiungi
"sameAs"ovunque: collega le entità ai loro profili su altre piattaforme (GitHub, LinkedIn, X). Segnala al motore AI che l’entità è reale e verificabile. - Includi
"description"in ogni tipo di schema: i LLM leggono il campo description come riassunto. Deve essere conciso, fattuale e auto-contenuto. - Usa
"mentions"e"about": segnala i temi e le entità menzionate nell’articolo. Aiuta i LLM a contestualizzare il contenuto.
Per approfondire l’ottimizzazione AI, leggi la nostra guida a llms.txt per WordPress e la guida alla GEO Optimization.
Schema Markup per Tipi di Sito Specifici
Siti e-commerce (WooCommerce)
Per siti WooCommerce, i tipi di schema essenziali sono Product, Offer, AggregateRating e BreadcrumbList. Il plugin WooCommerce genera automaticamente il Product schema base, ma per rich result completi (prezzi, stock, stelline) serve configurazione aggiuntiva.
Siti di ristoranti e hotel
Per ristoranti e hotel, usa LocalBusiness con sottotipi Restaurant o Hotel. Includi sempre servesCuisine, priceRange, openingHours e acceptsReservations per i ristoranti.
Siti della Pubblica Amministrazione
Per i siti della PA italiana, l’accessibilità e i dati strutturati hanno requisiti specifici. Usa GovernmentOrganization come tipo principale e includi i contatti ufficiali. Consulta la nostra guida alla sicurezza WordPress per la PA.
FAQ: Domande Frequenti sullo Schema Markup WordPress
Lo schema markup migliora direttamente il ranking?
No, non è un ranking factor diretto. Google lo usa per generare rich result, che migliorano il CTR. L’aumento di traffico indiretto può portare a segnali positivi che influenzano il ranking. I motori AI invece usano i dati strutturati direttamente come fonte di informazione per generare risposte citabili.
Quanti tipi di schema posso usare in una pagina?
Non c’è un limite tecnico. In pratica, una pagina può avere Article + BreadcrumbList + FAQPage simultaneamente. Ogni tipo deve però riflettere contenuti effettivamente presenti nella pagina. Evita di aggiungere schemi che non corrispondono al contenuto visibile.
Il plugin SEO genera già schema markup. Devo aggiungere altro?
I plugin SEO generano Article, Organization e Breadcrumb automaticamente. Per tipi specifici (HowTo, FAQ, Product, Event) spesso serve configurazione manuale o un plugin aggiuntivo. Verifica sempre con il Rich Results Test cosa viene effettivamente generato.
Lo schema markup rallenta il sito?
No. Il JSON-LD è un blocco di testo nel <head> della pagina, tipicamente 1-5KB. Non impatta le Core Web Vitals né il tempo di caricamento. Evita però di generare schemi enormi (centinaia di voci) su ogni pagina.
Checklist Schema Markup WordPress 2026
Prima di considerare completata l’implementazione dello schema markup su un sito WordPress client, verifica ogni punto di questa checklist:
- ☐ Un solo plugin SEO attivo (no duplicati)
- ☐ Article schema generato per ogni post del blog
- ☐ Organization schema nella homepage
- ☐ BreadcrumbList su ogni pagina con gerarchia
- ☐ FAQ schema su pagine con domande frequenti
- ☐ Person schema per ogni autore con sameAs ai social
- ☐ Immagini in evidenza di almeno 1200x630px
- ☐ Date in formato ISO 8601
- ☐ Validazione passata su Rich Results Test per homepage, post tipo, pagina tipo
- ☐ Search Console: zero errori in Enhancements
- ☐
@idstabili per entità (autore, organizzazione) - ☐
sameAsconfigurato per Organization e Person
Conclusione
Lo schema markup WordPress nel 2026 è un requisito tecnico non negoziabile per qualsiasi sito che vuole essere visibile sia nelle SERP tradizionali sia nei risultati generati dai motori AI. L’implementazione corretta non richiede plugin premium o competenze avanzate: serve disciplina, validazione costante e una procedura standardizzata.
Nella nostra gestione di 50+ siti con AgencyPilot, abbiamo visto agenzie perdere traffico del 30% per dati strutturati errati mai validati. Al contrario, i siti con schema markup corretto e monitorato mantengono rich result stabili e vengono citati con maggiore frequenza nelle risposte AI. Se gestisci siti WordPress per clienti, lo schema markup è uno dei servizi a più alto ROI che puoi offrire.
Per automatizzare la gestione di schema markup su multipli siti WordPress, AgencyPilot include audit automatici dei dati strutturati, report mensili sugli errori di schema e monitoraggio continuo via Search Console API.