Schema Markup

Definicion rapida

Schema Markup es el uso concreto del vocabulario Schema.org para marcar contenido de una pagina web. Describe en el codigo que significa una informacion: esto es un articulo, esto es un producto, esto es un autor, esto es una organizacion, esto es un precio, esto es un breadcrumb o esto es un video.

Si Structured Data es el principio general, Schema Markup es el idioma practico. Convierte contenido visible en declaraciones legibles por maquina. Los buscadores tienen que adivinar menos y pueden entender con mas claridad contenido, entidades y relaciones.

Importante: Schema Markup no es una palanca directa de ranking. Es una capa de comprension y puede hacer que paginas sean elegibles para ciertos rich results. Que un rich result aparezca realmente depende de Google, la feature, la calidad, el contexto de busqueda y las guidelines.

Explicacion sencilla

Una persona mira una pagina de producto y reconoce de inmediato el nombre, la imagen, el precio, la etiqueta "en stock" y las resenas. Para una maquina, al principio eso son textos, numeros, enlaces e imagenes dentro de un documento HTML.

Schema Markup pone etiquetas a esa informacion. Dice: este numero no es solo un numero, es un precio. Esta persona no es solo un nombre, es el autor. Esta lista no es cualquier lista, es un camino breadcrumb. Esta empresa no es solo una palabra en el footer, es la organizacion detras del sitio.

Por eso el markup es util: explica significado. Y el significado importa en SEO moderno, porque los sistemas de busqueda no solo comparan keywords. Intentan entender entidades, roles, relaciones y tipos de pagina.

Por que Schema Markup importa para SEO

Schema Markup ayuda a los sistemas de busqueda a interpretar contenido con mas precision. Es especialmente util en paginas con mucha informacion estructurada: productos, empleos, recetas, eventos, videos, negocios locales, perfiles de autor, resenas o articulos de conocimiento.

El efecto SEO mas visible son los rich results. Paginas de producto pueden mostrar precio o disponibilidad. Breadcrumbs pueden hacer el resultado mas comprensible. Articulos pueden ofrecer metadatos mas limpios. Videos pueden procesarse con miniatura e informacion temporal.

El valor mas profundo es la consistencia. Un sitio grande puede tener cientos de autores, miles de productos o muchas ubicaciones. Sin markup claro, las senales se vuelven facilmente incoherentes. Con buen Schema Markup, las entidades recurrentes y los tipos de pagina se describen de forma sistematica.

Esto no sustituye buen contenido. Si una pagina es pobre, imprecisa o poco util, Schema Markup no la vuelve valiosa. Solo hace que lo que existe de verdad sea mas legible para maquinas.

Schema Markup, Structured Data y Schema.org

Estos tres terminos se usan a menudo como si fueran iguales, pero distinguirlos ayuda.

Structured Data es el concepto general. Significa que la informacion se ofrece de forma estructurada para que las maquinas puedan leerla.

Schema.org es el vocabulario. Ofrece tipos y propiedades como Product, Article, Organization, Person, BreadcrumbList, Event, VideoObject o JobPosting.

Schema Markup es la aplicacion de ese vocabulario en una pagina web. En la practica, normalmente se implementa como JSON-LD, un bloque script dentro del HTML. Microdata y RDFa tambien son posibles, pero JSON-LD suele ser mas mantenible para equipos SEO y de desarrollo.

Una frase util: Structured Data es la idea, Schema.org es el diccionario y Schema Markup es la frase concreta en tu pagina.

Como funciona el vocabulario Schema.org

Tipos

Los tipos describen que es algo. Un Article es un articulo. Un Product es un producto. Una Organization es una organizacion. Un BreadcrumbList es una lista de breadcrumbs.

El tipo es la primera gran decision. Si el tipo es incorrecto, propiedades perfectas no lo arreglan. Una pagina de categoria no deberia recibir Product markup solo porque los rich results de producto se ven atractivos. Una guia no es automaticamente una FAQPage porque responde preguntas.

Propiedades

Las propiedades describen atributos de un tipo. Un Product puede tener name, image, brand, offers y aggregateRating. Un Article puede tener headline, author, datePublished, dateModified, image y publisher.

Algunas propiedades son obligatorias para rich results concretos de Google; otras son recomendadas. Los campos obligatorios suelen decidir elegibilidad. Los campos recomendados no mejoran automaticamente rankings, pero pueden hacer que el resultado sea mas completo y util.

Entidades anidadas

Buen Schema Markup suele estar anidado. Un articulo tiene un autor, y ese autor es una Person u Organization. Un producto tiene una Offer, y esa offer tiene precio y disponibilidad. Un BreadcrumbList tiene varios elementos ListItem.

Ese anidamiento importa porque describe relaciones. Los buscadores ven no solo hechos aislados, sino un pequeno modelo de la pagina.

Entidades estables con @id

En sitios grandes, @id puede ayudar a identificar entidades de forma estable. La organizacion detras del sitio puede tener el mismo ID en muchas paginas. Un perfil de autor puede tener un ID unico. Asi el sitio parece menos una pila de paginas separadas y mas un sistema consistente.

@id no es una etiqueta SEO magica. Es una herramienta de estructura. Ayuda sobre todo cuando el markup se mantiene limpio en varios templates.

sameAs y perfiles

sameAs puede apuntar a perfiles o paginas oficiales de la misma entidad, por ejemplo perfiles sociales o una pagina de empresa. Debe usarse con moderacion y verdad. El objetivo no es llenar JSON-LD de enlaces, sino hacer la identidad mas verificable.

Pequeno ejemplo JSON-LD

Este es un ejemplo simplificado de markup para un articulo con autor y publisher:

``json { "@context": "https://schema.org", "@graph": [ { "@type": "Organization", "@id": "https://www.contextter.com/#organization", "name": "Contextter", "url": "https://www.contextter.com/" }, { "@type": "Person", "@id": "https://www.contextter.com/authors/matthias-ramahi/#person", "name": "Matthias Ramahi" }, { "@type": "Article", "@id": "https://www.contextter.com/glossary/schema-markup/#article", "headline": "Schema Markup explicado de forma sencilla", "author": { "@id": "https://www.contextter.com/authors/matthias-ramahi/#person" }, "publisher": { "@id": "https://www.contextter.com/#organization" } } ] } ``

El ejemplo muestra mas que campos individuales. Muestra relaciones. La organizacion es el publisher, la persona es el autor y el articulo apunta a ambos. Esa logica relacional separa buen Schema Markup de una lista suelta de valores.

Tipos Schema importantes para SEO

Article, BlogPosting y NewsArticle

Estos tipos ayudan en paginas editoriales. Describen titulo, autor, imagenes, fecha de publicacion, fecha de modificacion y publisher. Suelen ser utiles para blogs, glosarios, noticias y articulos de conocimiento.

La informacion visible de autor, fechas y calidad editorial sigue importando. El markup no debe fingir autoridad que la pagina no muestra.

Product y Offer

Product markup esta pensado para paginas reales de detalle de producto. Puede estructurar precio, disponibilidad, marca, imagenes, resenas y variantes. En ecommerce deberia venir de datos reales de producto, no de ejemplos hardcoded.

Si precios, stock o resenas en el markup difieren de la pagina visible, el problema se vuelve serio rapido. Usuarios y sistemas de busqueda esperan consistencia.

BreadcrumbList

BreadcrumbList describe donde esta una pagina dentro de la estructura del sitio. Suele ser uno de los markups base mas limpios porque hace explicita la jerarquia. Sitios grandes con hubs, categorias y paginas de detalle se benefician mucho.

Organization, LocalBusiness y Person

Estos tipos estructuran identidad. Ayudan con marcas, empresas, ubicaciones, autores y contactos. Para entity SEO importan porque mantienen nombres, perfiles, logos y relaciones consistentes.

VideoObject, Event y JobPosting

Estos tipos estan mas ligados a features y guidelines concretas. Solo deben usarse si el contenido encaja de verdad y se sigue la documentacion especifica de Google. Un VideoObject sin video visible o un Event sin detalles reales de evento no es buen markup.

Elegir el tipo Schema correcto

No empieces con la pregunta: "Que rich result queremos?" Empieza con: "Que es realmente esta pagina?"

Una pagina de detalle de producto, una categoria, una entrada de glosario, una herramienta, una landing page y una guia tienen trabajos distintos. El markup deberia reflejar ese trabajo.

Despues revisa si Google documenta un rich result para ese tipo. Schema.org contiene muchisimos tipos, pero Google usa solo una parte para apariencias especiales. Un tipo Schema.org puede ser valido sin producir un rich result de Google.

Si varios tipos son posibles, elige el tipo mas especifico que siga siendo verdadero. Un markup general correcto es mejor que un markup especifico forzado que la pagina no puede sostener.

Implementacion: flujo de datos limpio, no caos de plugins

Muchos sitios tienen problemas de schema porque varios plugins, temas o templates publican JSON-LD al mismo tiempo. Eso puede crear organizaciones duplicadas, autores contradictorios, logos distintos o varios breadcrumbs.

Una implementacion profesional empieza con una fuente de verdad. Los autores vienen del CMS. Los datos de organizacion vienen de un registro central de marca. Los datos de producto vienen del feed de producto. Los breadcrumbs vienen de la navegacion real.

El codigo deberia generar JSON-LD consistente desde esas fuentes. Si falta un campo, el template deberia reaccionar de forma intencional: saltar el markup, crear una advertencia o completar el contenido. Malos datos no deberian publicarse en silencio como schema aparentemente valido.

Internacionalizacion y canonicals

En sitios internacionales, Schema Markup debe coincidir con la version de idioma. Una pagina alemana deberia publicar titulos alemanes, descripciones alemanas y la URL correcta. Una version inglesa necesita sus propios valores. Las organizaciones pueden mantenerse estables entre idiomas, pero articulos, breadcrumbs y titulos de pagina deben localizarse.

Canonicals y hreflang tambien deberian coincidir con la salida estructurada. Si el markup apunta a una URL incorrecta o describe otro idioma, crea confusion. Los grandes portfolios de contenido se benefician de tests automaticos por locale.

Validacion y monitoring

Rich Results Test es la primera comprobacion mas importante cuando apuntas a un rich result de Google. Muestra si Google entiende el markup para features soportadas y que errores o warnings existen.

Schema Markup Validator comprueba de forma mas amplia si el markup Schema.org es estructuralmente legible. Es util cuando construyes markup que no busca activar directamente un rich result de Google.

Search Console es el control de realidad despues del lanzamiento. Muestra si Google detecta markup en URLs reales y si aparecen errores por grupos de URL. Un solo test verde antes del deploy no basta si un template luego corre en miles de paginas.

Ejemplo practico

Un content hub contiene entradas de glosario, guias y paginas de comparacion de productos. El equipo quiere "anadir schema". El camino rapido pero debil seria copiar el mismo bloque Article en todas partes.

El mejor camino empieza con tipos de pagina. Los terminos de glosario reciben Article markup y tambien pueden modelarse como terminos definidos cuando el modelo de contenido lo permite. Las guias reciben Article o BlogPosting con autor visible, fecha y logica de actualizacion. Las comparativas de producto usan Product o markups cercanos a Review solo si hay productos reales, resenas visibles y guidelines que lo soportan.

Organization y BreadcrumbList se emiten luego de forma consistente en paginas relevantes. Los autores reciben perfiles estables. Cada version de idioma obtiene valores locales correctos. El resultado no es un patchwork de bloques schema, sino una estructura semantica clara.

Errores frecuentes

• Tratar Schema Markup como un truco de ranking.
• Marcar contenido invisible.
• Elegir el rich result mas atractivo en vez del tipo de pagina mas verdadero.
• Forzar Product markup en categorias o guias.
• Publicar datos de resenas que usuarios no pueden ver.
• Dejar que varios plugins publiquen markup sin revisar al mismo tiempo.
• Usar @id y sameAs como deposito de enlaces.
• Mantener campos obligatorios manualmente hasta que queden obsoletos.
• Confundir validez Schema.org con elegibilidad para rich result de Google.
• Probar una sola URL aunque el template tenga muchas variantes.
• Publicar markup multilingue sin localizarlo.

Mini workflow

1. Define la funcion principal de la pagina. 2. Elige el tipo Schema.org segun el contenido real. 3. Revisa la documentacion actual de Google para requisitos de rich result. 4. Define campos obligatorios, campos recomendados y campos opcionales de entidad. 5. Conecta cada campo con una fuente real de datos. 6. Planifica IDs estables para entidades recurrentes. 7. Genera JSON-LD a nivel de template y evita fuentes contradictorias. 8. Prueba varias variantes de pagina y varios locales. 9. Valida con Rich Results Test y Schema Markup Validator. 10. Monitoriza Search Console despues del deploy.

Perspectiva Contextter

Contextter puede preparar Schema Markup antes dentro del proceso de contenido. Si un brief ya define entidades, autores, fuentes, tipos de pagina y relaciones importantes, el markup no tiene que adivinarse despues desde paginas poco claras.

Para SEO scoring, la pregunta no es: "Tenemos algun schema?" La mejor pregunta es: "El markup describe esta pagina de forma verdadera, consistente, actual y comprobable?"

Esto encaja con trabajo profesional de contenido. Buen contenido necesita estructura clara para personas. Buenos sistemas SEO tambien necesitan estructura clara para maquinas. Schema Markup conecta ambos cuando se planifica bien.

Terminos relacionados

Estos terminos son buenos siguientes pasos:

• structured-data
• rich-snippet
• knowledge-graph
• technical-seo-advanced
• content-optimization

Fuentes para la revision

• Schema.org: schemas
• Schema.org: getting started
• Schema.org: home
• Google Search Central: Intro to structured data markup
• Google Search Central: Search Gallery
• Google Search Central: General structured data guidelines
• Google Search Central: Rich Results Test
• Schema.org: validator