Yoast SEO y Rank Math agregan ambos JSON-LD que describe su sitio, la página, el autor, la ruta de navegación y el contenido principal. Los dos pueden ampliarse con su propio código. Antes de escribir cualquier marcado personalizado, averigüe qué entidades ya genera el plugin para el tipo de página con el que trabaja.
El orden que funciona para cualquiera de los dos plugins es breve. Configure primero los ajustes del sitio, de los tipos de contenido, del autor y de la ruta de navegación. Use los bloques integrados solo cuando coincidan con lo que los visitantes pueden ver. Después, agregue JSON-LD personalizado mediante la API de Schema de Yoast o los filtros de Rank Math, devolviendo la entidad completa en lugar de una segunda copia de ella.
Los dos plugins se diferencian en cómo controlan la salida. Yoast se centra en un solo grafo conectado. Rank Math permite elegir un tipo de schema de forma global o por entrada, así que su grafo depende del tipo de página, de los ajustes y de los módulos activos.
Qué agrega Yoast SEO por defecto
La especificación para desarrolladores de Yoast describe un grafo base formado por Organization o Person, WebSite y WebPage. En las entradas, Yoast suele agregar un Article, una Person para el autor y un BreadcrumbList. Cada pieza se enlaza con las demás mediante @id, un identificador estable que permite que una entidad apunte a otra en lugar de repetirla. La página de salida de Schema del plugin enumera las mismas piezas principales.
Los valores predeterminados dependen del tipo de contenido. Los ajustes de tipos de contenido de Yoast asignan a las páginas WebPage y a las entradas Article más WebPage, y usted puede cambiarlos allí. La documentación de Yoast advierte de que un cambio en esos valores se aplica a todo el contenido de ese tipo, así que pruebe una entrada y una página antes de guardar un cambio que afecte a todo el sitio.
Otras piezas del grafo dependen de la página y de las integraciones. Yoast documenta la salida para productos, videos, recetas, eventos, preguntas frecuentes y bloques HowTo, y para WooCommerce, Easy Digital Downloads, WP Recipe Maker y The Events Calendar, entre otros.
Los ajustes de Schema determinan cómo se representa el sitio, como organización o como persona, y los perfiles sociales que aparecen mediante sameAs. También incluyen los ajustes de la ruta de navegación y una selección de Schema por página en el editor. Yoast indica que la opción de grafo conectado normalmente debe permanecer activada, porque es lo que genera la salida enlazada descrita antes. La guía de implementación explica cómo encajan estas piezas.
Qué agrega Rank Math por defecto
Rank Math agrega JSON-LD para las entidades del sitio y de la página, y el administrador elige los tipos de schema de forma global y por entrada. La documentación de schema de Rank Math indica que el grafo exacto varía según el tipo de página, los ajustes y los módulos activados, así que la salida de una entrada de blog puede ser distinta de la de una página de producto o de un tipo de contenido personalizado.
La salida habitual puede incluir WebSite, Organization o Person, WebPage, Article y BreadcrumbList. Según el tipo que seleccione, Rank Math también puede generar marcado de producto, receta, evento, video, FAQ, HowTo, negocio local, curso, oferta de empleo y reseñas.
Los ajustes que determinan el resultado son el Default Schema Type (tipo de schema predeterminado) para entradas, páginas y tipos de contenido personalizados, la configuración del Schema Generator (generador de schema) por página, los controles de la ruta de navegación y los bloques de schema. La documentación de Rank Math también enumera los múltiples tipos de schema, Custom Schema y las plantillas de schema como funciones Pro, que trata la siguiente sección.
Como el grafo depende de los ajustes, a quienes usan Rank Math les conviene abrir la página tal como se muestra en el navegador y leer lo que se generó, en lugar de dar por supuesto un tipo a partir del menú desplegable. Un tipo seleccionado que no coincide con el contenido visible de la página es un ajuste que hay que cambiar, no un hueco que deba llenarse con código personalizado.
Controles de schema gratuitos y de pago
En Yoast, el plugin gratuito incluye el grafo conectado básico, las piezas estándar del grafo, los ajustes de tipos de contenido, los controles de representación del autor y del sitio, las rutas de navegación y las integraciones estándar. Ese grafo básico no requiere Premium. Algunas adiciones de schema llegan mediante plugins independientes, como Local SEO, Video SEO, News SEO o WooCommerce SEO. La documentación de tipos de contenido de Yoast también identifica la opción de campos personalizados como función Premium, pensada para desarrolladores que la usan con filtros.
En Rank Math, la versión gratuita ofrece los tipos de schema estándar y controles básicos de schema por entrada. La documentación de Rank Math indica que la pestaña Custom Schema no está operativa en la versión gratuita. El Custom Schema Generator y las plantillas de schema reutilizables aparecen como funciones Pro, junto con los múltiples tipos de schema y otros controles avanzados.
La disponibilidad de funciones cambia con el tiempo, así que revise la interfaz de la versión que tiene instalada antes de planificar en torno a un tipo específico. Un control de pago solo sirve cuando la página contiene el contenido correspondiente, y ninguno de los dos planes de pago promete posiciones ni resultados enriquecidos.
En la mayoría de las páginas, el grafo gratuito predeterminado de cualquiera de los dos plugins ya cubre las entidades del sitio, de la página, del autor y de la ruta de navegación. La elección suele depender de qué pantalla de ajustes y de qué vía de extensión prefiera usar.
Revise qué hay en su página antes de agregar nada
La forma más rápida de saber qué genera un plugin es leer la página tal como se publica. Abra una entrada en su navegador, vea el código HTML de la página y busque application/ld+json. Cada bloque que encuentre es un elemento script con JSON-LD. Anote si los bloques están en un solo arreglo @graph o en varios scripts separados, y escriba qué valores de @type aparecen.
Después, identifique el origen de cada entidad. Un grafo con WebSite, WebPage, Article, Person y BreadcrumbList enlazados mediante @id es lo habitual en la salida propia del plugin. Un bloque Article u Organization aparte, con valores @id distintos, suele venir de un tema o de otro plugin, y ahí es donde empiezan los duplicados.

Un ejemplo breve muestra cómo se ve un resultado conectado. Este grafo ficticio usa URLs de example.com y recorta varias propiedades para que ocupe menos espacio. El Article apunta a su WebPage y a su editor (publisher), y la WebPage apunta al BreadcrumbList. Reemplace los nombres, las URLs y las fechas por los datos que aparecen en su propia página.
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Article",
"@id": "https://example.com/blog/example-article/#article",
"isPartOf": { "@id": "https://example.com/blog/example-article/" },
"mainEntityOfPage": { "@id": "https://example.com/blog/example-article/" },
"headline": "Una guía ficticia sobre datos estructurados",
"image": ["https://example.com/images/example-article-16x9.jpg"],
"author": {
"@type": "Person",
"@id": "https://example.com/about/example-author/#person",
"name": "Autor de ejemplo",
"url": "https://example.com/about/example-author/"
},
"publisher": { "@id": "https://example.com/#organization" },
"datePublished": "2026-01-15T09:00:00-06:00",
"dateModified": "2026-02-01T10:30:00-06:00",
"articleSection": "Guías",
"inLanguage": "es-MX"
},
{
"@type": "WebPage",
"@id": "https://example.com/blog/example-article/",
"url": "https://example.com/blog/example-article/",
"name": "Una guía ficticia sobre datos estructurados",
"isPartOf": { "@id": "https://example.com/#website" },
"breadcrumb": { "@id": "https://example.com/blog/example-article/#breadcrumb" },
"inLanguage": "es-MX"
},
{
"@type": "WebSite",
"@id": "https://example.com/#website",
"url": "https://example.com/",
"name": "Editorial de ejemplo",
"publisher": { "@id": "https://example.com/#organization" }
},
{
"@type": "Organization",
"@id": "https://example.com/#organization",
"name": "Editorial de ejemplo",
"url": "https://example.com/"
},
{
"@type": "BreadcrumbList",
"@id": "https://example.com/blog/example-article/#breadcrumb",
"itemListElement": [
{ "@type": "ListItem", "position": 1, "name": "Inicio", "item": "https://example.com/" },
{ "@type": "ListItem", "position": 2, "name": "Blog", "item": "https://example.com/blog/" },
{ "@type": "ListItem", "position": 3, "name": "Una guía ficticia sobre datos estructurados" }
]
}
]
}La documentación de Article de Google indica que para esa función no es obligatoria ninguna propiedad de Article. Enumera headline, image, author, datePublished y dateModified como recomendadas, y estos campos siguen siendo útiles para la claridad. La documentación de ruta de navegación de Google exige al menos dos objetos ListItem, cada uno con position y name, y una URL en item para las entradas que representan una página. La última entrada puede omitir item. Son reglas de la función de Google, no requisitos para Bing, Yandex o Apple. La página de Schema.org Article define el vocabulario en sí.
Si la Organization de su sitio necesita su propia definición, la guía sobre schema de organización en cada página explica dónde definirla una sola vez y cómo hacer referencia a ella desde otros lugares. La guía sobre datos estructurados en WordPress cubre el conjunto más amplio de rutas de instalación.
Amplíe Yoast con su API de Schema
La API de Schema de Yoast permite a los desarrolladores agregar piezas al grafo, eliminarlas y modificar las existentes. También les permite conectar entidades personalizadas mediante @id, integrar plugins de terceros y tipos de contenido personalizados, y evitar que otro sistema genere salida duplicada. La idea es que su adición se una al grafo que Yoast ya genera, en lugar de llegar como un segundo grafo sin relación.
Empiece por la página de salida de Schema de Yoast y la documentación de integración, y confirme los nombres de funciones y filtros con la versión del plugin que tiene instalada, ya que esos nombres son la parte que con más probabilidad cambia. Use identificadores estables en todo lo que agregue, y describa solo contenido que los visitantes puedan ver en la página.
Un orden práctico para Yoast es definir primero la representación y los valores predeterminados. Indique si el sitio es una organización o una persona, agregue los perfiles sociales y revise los valores predeterminados de los tipos de contenido y los ajustes de la ruta de navegación. Después, use los bloques FAQ y HowTo de Yoast solo en las páginas donde el contenido visible sea realmente una serie de preguntas o una serie de pasos. Agregue código personalizado al final, para una entidad que el plugin no genera, como un video que aparece en la página.
Amplíe Rank Math con filtros
Rank Math documenta un filtro general, rank_math/json_ld, que modifica el arreglo de datos de JSON-LD antes de la salida. La página de filtros y hooks de Rank Math muestra el patrón siguiente. La función recibe los datos y el objeto JSON-LD, y tal como está escrita devuelve los datos sin cambios, así que es un punto de partida y no una personalización terminada.
add_filter( 'rank_math/json_ld', function( $data, $jsonld ) {
return $data;
}, 99, 2 );Para una sola entidad, Rank Math documenta filtros específicos por entidad. El ejemplo siguiente modifica la entidad Article al agregar un valor articleSection. Reemplace Guías por el nombre de sección que corresponda a su sitio.
add_filter( 'rank_math/snippet/rich_snippet_article_entity', function( $entity ) {
$entity['articleSection'] = 'Guías';
return $entity;
} );Dos reglas se aplican a todos los filtros de este tipo. El nombre de schema del filtro debe coincidir con la entidad que modifica, y la función debe devolver la entidad completa modificada, conservando los datos válidos que ya existían. Devolver solo el campo que cambió eliminaría el resto.
Rank Math recomienda colocar las personalizaciones en un archivo rank-math.php dedicado dentro del tema activo, para que se ejecuten solo cuando Rank Math esté activo; use un tema hijo para que una actualización del tema no los elimine. Un plugin personalizado pequeño o un tema hijo es otro lugar fácil de mantener para el código.
Evite entidades duplicadas Article, Product, FAQPage y BreadcrumbList
Una segunda copia de una entidad es la forma habitual en que una adición personalizada sale mal. Si el plugin ya genera un Article para una entrada, un segundo bloque Article procedente de un fragmento de código, de un tema o de otro plugin da a los sistemas de búsqueda dos descripciones de la misma cosa, que pueden no coincidir en el titular, el autor o las fechas. Lo mismo ocurre con Product, FAQPage y BreadcrumbList.

Revise el código HTML de la página en tres pasos. Primero, anote cada tipo de entidad y cuente cuántas veces aparece para el contenido principal. Segundo, identifique el origen de cualquier entidad extra, ya sea el tema, otro plugin o su propio script. Tercero, desactive la salida extra en su origen o combínela con la entidad del plugin mediante un filtro. Mantenga entidades separadas solo cuando la página contenga visiblemente cosas distintas, como un video, un producto, una receta o un evento, y asigne a cada una su propio @id.
Las directrices generales de datos estructurados de Google indican que el marcado debe describir el contenido visible, y permiten varias entidades en una página. Varias entidades válidas no son un problema. El riesgo son los duplicados en conflicto de una misma entidad. Las guías sobre schema de artículo, schema de ruta de navegación y grafo en JSON-LD profundizan en cada pieza.
Tener los dos plugins activos a la vez favorece una salida superpuesta, porque cada uno puede generar las mismas entidades. Defina la salida de schema de un solo plugin para el sitio y, para cualquier elemento personalizado, use los filtros mencionados antes.
Cambie entre Yoast y Rank Math
Ambos proveedores documentan importadores. Para pasar de Rank Math a Yoast, los pasos de migración de Yoast empiezan con una copia de seguridad del sitio. Después, desactive Rank Math, instale Yoast SEO, abra Tools (herramientas), luego Import and Export (importar y exportar), elija Import from other SEO plugins (importar desde otros plugins de SEO) y seleccione Rank Math. Luego confirme títulos, descripciones, frases clave, redirecciones y la salida de cada página, complete la configuración inicial de Yoast y elimine los datos antiguos solo después de verificar. La página de importación y exportación de Yoast enumera las opciones de importación e indica cuáles son Premium.
Para pasar de Yoast a Rank Math, la guía de migración de Rank Math también empieza con una copia de seguridad. Instale Rank Math y luego ejecute el Setup Wizard (asistente de configuración) o abra Status and Tools (estado y herramientas), después Import and Export (importar y exportar), y seleccione el importador de Yoast SEO. Revise títulos, descripciones, URLs canónicas, redirecciones y metadatos sociales. Si usó los bloques FAQ o HowTo de Yoast, el Yoast Block Converter de Rank Math se encarga de ellos. Verifique el JSON-LD publicado después del cambio, y elimine el plugin antiguo solo cuando la nueva salida esté confirmada. La documentación de importación y exportación de Rank Math explica el comportamiento del importador.
Importar los campos de SEO no equivale a trasladar cada nodo del grafo generado ni cada integración personalizada, y los formatos de exportación no son intercambiables entre plugins. Antes de cambiar, guarde el JSON-LD del plugin anterior de una entrada, una página y un producto representativos, y conserve cualquier código personalizado. Tras la activación, compare la nueva salida con la copia guardada y busque JSON-LD duplicado.
Pruebe la salida en las herramientas de Google, Bing y Yandex
La Prueba de resultados enriquecidos (Rich Results Test) y la herramienta URL Inspection (Inspección de URL) de Google muestran cómo Google lee una página. La documentación de datos estructurados de Bing indica que admite Schema.org en JSON-LD, Microdata y RDFa, así que la misma salida del plugin sirve para ambos buscadores, y la tarjeta Markup (marcado) de la herramienta URL Inspection de Bing muestra lo que Bing encontró. Yandex ofrece un validador de datos estructurados e indica en sus preguntas frecuentes sobre marcado que no admite todos los tipos de Schema.org, así que use los requisitos propios de Yandex para sus visualizaciones. El validador de schema de Schema Nova es otro lugar para pegar un bloque o revisar una página.
Para que ChatGPT search y Perplexity puedan llegar a la página, permita OAI-SearchBot y PerplexityBot en robots.txt, como describen la página de ayuda de OpenAI sobre la búsqueda en ChatGPT y la guía de rastreadores de Perplexity. El marcado preciso sigue siendo útil en cualquier caso; consulte si los sistemas de IA usan el marcado schema.
Qué visualizaciones de Google siguen existiendo
Un tipo del vocabulario de Schema.org y una función de Google Search son cosas distintas. La galería de búsqueda de Google enumera las funciones de datos estructurados que Google Search admite, entre ellas Article, Breadcrumb, Organization, Product, Recipe, Review Snippet, Video y Local Business. Un tipo que no aparece en la galería sigue siendo marcado válido de Schema.org cuando describe la página con veracidad.
Google indica que los resultados enriquecidos de preguntas frecuentes dejaron de aparecer en Google Search el 7 de mayo de 2026, así que FAQPage sigue siendo vocabulario válido sin una visualización actual en Google. En junio de 2025, Google también indicó, en una entrada titulada Simplifying the search results page, que simplificaba la página de resultados al retirar varias visualizaciones de datos estructurados, y que el cambio no afectaba a las posiciones. Una sección visible de preguntas frecuentes puede seguir ayudando a los lectores, y otros sistemas pueden leer el marcado, pero no debe presentarse como un resultado enriquecido vigente de Google.
La misma distinción vale para WebSite, WebPage, Person y Organization como descripciones generales. Cumplen una función real en el grafo conectado, porque otras entidades apuntan a ellas, aunque Google no enumere una visualización específica para ellas. Vuelva a revisar la galería de búsqueda antes de agregar un tipo para una visualización de Google, porque el soporte de funciones cambia.
Preguntas frecuentes
¿Qué schema agrega Yoast SEO por defecto?
La especificación para desarrolladores de Yoast describe un grafo base de Organization o Person, WebSite y WebPage. En las entradas suele agregar un Article, el autor como Person y un BreadcrumbList, enlazados mediante @id. Las piezas adicionales dependen de la página y de sus integraciones, como WooCommerce o los bloques FAQ y HowTo del plugin.
¿Qué schema agrega Rank Math por defecto?
Rank Math agrega JSON-LD para las entidades del sitio y de la página, y usted elige un tipo de schema de forma global y por entrada. La salida habitual incluye WebSite, Organization o Person, WebPage, Article y BreadcrumbList. El grafo exacto depende del tipo de página, de sus ajustes y de los módulos que tenga activados.
¿Está disponible el schema personalizado de Rank Math en la versión gratuita?
La documentación de Rank Math indica que la pestaña Custom Schema no está operativa en la versión gratuita. Enumera el Custom Schema Generator y las plantillas de schema reutilizables como funciones Pro.
¿Pueden funcionar Yoast y Rank Math juntos?
Ambos plugins pueden generar entidades superpuestas, lo que supone un riesgo de JSON-LD en conflicto o duplicado. Los pasos de migración de cada proveedor describen un traslado en una sola dirección, con el plugin anterior eliminado una vez confirmada la nueva salida. Elija un plugin para la salida de schema y amplíelo mediante sus propios filtros.
¿Cómo pruebo JSON-LD?
Abra el código HTML de la página publicada, busque los scripts application/ld+json y pruebe la URL con la Prueba de resultados enriquecidos de Google, Bing Webmaster Tools, el validador de Yandex y el validador de Schema Nova. Cada herramienta revisa reglas distintas. Un resultado limpio tampoco garantiza un resultado enriquecido, una visualización ni una cita en una respuesta de IA.
¿Cuál es la diferencia entre Schema.org y los resultados enriquecidos de Google?
Schema.org es un vocabulario compartido de tipos y propiedades para describir cosas en la web. JSON-LD es un formato para escribir ese vocabulario en una página, y datos estructurados es el término general para el conjunto. Un resultado enriquecido es una apariencia más rica que un buscador puede mostrar cuando se cumplen sus propios requisitos, y Google indica que el marcado válido no garantiza ninguno.
¿El schema de preguntas frecuentes sigue produciendo resultados enriquecidos de Google?
Google indica que los resultados enriquecidos de preguntas frecuentes dejaron de aparecer en Google Search el 7 de mayo de 2026. FAQPage sigue siendo vocabulario válido de Schema.org. La guía de schema de preguntas frecuentes explica qué hacer con una sección de preguntas frecuentes que ya existe.
