Guía 2 · Serie de datos estructurados
Schema.org explicado fácil: tipos, propiedades y cómo elegirlos
Schema.org es un vocabulario para describir entidades y contenidos mediante tipos y propiedades. Permite indicar, por ejemplo, que una página habla de una organización, un artículo, un producto, un servicio, un curso o un evento.
Esta guía explica cómo leer el vocabulario, distinguir tipos de propiedades, relacionar entidades y seleccionar el marcado apropiado. La implementación mediante JSON-LD se trabajará por separado en el siguiente módulo.
Cómo leer Schema.org sin complicarse
Una implementación puede entenderse como una ficha de información. Primero se identifica la entidad principal y luego se añaden propiedades que describen aquello que realmente aparece en la página.
Tipo
Define qué es la entidad: Organization, Article, Product o Course.
Propiedad
Indica qué dato se describe: name, url, image o provider.
Valor
Contiene el dato concreto, como un nombre, una URL, una fecha o una entidad relacionada.
Identificador
Permite referirse de forma consistente a la misma entidad mediante @id.
Anatomía sencilla de una entidad
Este ejemplo conceptual describe un servicio. Se muestra como texto educativo y no está pensado para copiarse directamente en una página.
{
"@type": "Service",
"@id": "https://sitio.cl/servicio/#service",
"name": "Nombre visible del servicio",
"url": "https://sitio.cl/servicio/",
"provider": {
"@id": "https://sitio.cl/#organization"
}
}| Elemento | Función | Pregunta que responde |
|---|---|---|
| @type | Clasifica la entidad | ¿Qué es? |
| @id | Entrega un identificador estable | ¿Cómo se reconoce esta misma entidad? |
| name | Declara el nombre | ¿Cómo se llama? |
| url | Relaciona la entidad con una URL | ¿Dónde está su página? |
| provider | Vincula el servicio con quien lo presta | ¿Quién lo ofrece? |
Tipos, subtipos y herencia en Schema.org
Schema.org organiza los tipos mediante jerarquías. Un subtipo hereda propiedades de tipos más generales y puede añadir propiedades específicas. Por eso conviene utilizar el tipo más específico que represente fielmente la entidad, sin forzar una clasificación.
Elegir un subtipo específico no significa que obtendrás una ventaja automática. Debe existir información suficiente para describirlo y mantenerlo correctamente.
Propiedades y tipos de valores
Cada propiedad admite determinados tipos de valores. Algunos son textos simples y otros son entidades completas que deben describirse o referenciarse.
| Tipo de valor | Ejemplo de propiedad | Uso |
|---|---|---|
| Text | name, description | Nombre o descripción legible |
| URL | url, sameAs | Dirección web válida y aplicable |
| Date / DateTime | datePublished, startDate | Fecha o fecha con hora en un formato coherente |
| Number | ratingValue, position | Valor numérico dentro del contexto esperado |
| Boolean | isAccessibleForFree | Valor verdadero o falso cuando la propiedad lo admite |
| Entidad | author, provider, image | Objeto relacionado o referencia mediante @id |
Una propiedad puede aceptar más de un tipo de valor. La documentación del vocabulario indica los dominios y rangos aplicables, pero los requisitos de una función de Google deben revisarse por separado.
Tipos de Schema.org frecuentes y cuándo utilizarlos
| Tipo | Representa | No debería utilizarse para |
|---|---|---|
| Organization | Organización, marca o entidad responsable | Repetir una organización distinta en cada página |
| LocalBusiness | Negocio local con información aplicable | Cualquier sitio que atienda clientes en internet |
| Article | Artículo editorial, guía o noticia | Páginas comerciales sin naturaleza editorial |
| BlogPosting | Publicación dentro de un blog | Todo contenido solamente porque está en WordPress |
| Product | Producto específico descrito en la página | Cualquier servicio profesional o categoría general |
| Offer | Oferta comercial con condiciones aplicables | Un precio aislado sin entidad ofrecida |
| Service | Servicio y relación con su proveedor | Garantizar una presentación especial en Google |
| Course | Curso o programa educativo identificable | Cualquier artículo educativo o lección aislada |
| Event | Evento con fecha, estado, lugar o modalidad | Un servicio disponible permanentemente |
| FAQPage | Conjunto de preguntas y respuestas visibles | Preguntas ocultas, inventadas o diferentes al contenido |
| BreadcrumbList | Ruta jerárquica de navegación | Una lista arbitraria de enlaces relacionados |
| VideoObject | Video principal con sus metadatos | Una página que solamente enlaza un video externo sin contexto |
Cómo elegir el tipo principal de Schema
La elección comienza por la entidad principal de la URL, no por una lista de tipos que deseas añadir.
- Resume la página en una frase: “esta URL presenta un servicio”, “esta URL explica un tema” o “esta URL vende un producto”.
- Identifica la entidad principal: determina qué cosa concreta se describe.
- Separa entidades secundarias: organización, autor, imagen, oferta o proveedor pueden estar relacionadas.
- Busca el tipo más específico y fiel: utiliza la jerarquía sin forzar un subtipo.
- Comprueba propiedades mantenibles: no declares información que el sitio no puede actualizar.
- Revisa qué genera el CMS: evita crear nuevas versiones de entidades existentes.
- Consulta requisitos externos: si buscas una función de Google, revisa su documentación y políticas actuales.
Matriz rápida para elegir el tipo
Utiliza esta tabla como orientación inicial, no como sustituto de una revisión de la página.
| La URL principalmente… | Tipo inicial que conviene evaluar | Entidad relacionada frecuente |
|---|---|---|
| Explica una noticia, guía o investigación | Article o un subtipo apropiado | Person u Organization como autor |
| Presenta un servicio profesional | Service | Organization como provider |
| Describe un producto comprable | Product | Offer y Brand cuando corresponda |
| Presenta un curso completo | Course | Organization como provider |
| Anuncia un evento con fecha | Event o subtipo aplicable | Place, VirtualLocation u Organization |
| Identifica el negocio | Organization o LocalBusiness apropiado | PostalAddress y ContactPoint |
| Incluye preguntas visibles | FAQPage, si representa la página | Question y Answer |
Cómo relacionar entidades con @id
@id permite identificar una entidad dentro del gráfico y volver a referenciarla sin crear versiones diferentes. No necesita corresponder a una página independiente; puede utilizar una URL estable con un fragmento descriptivo.
Ventajas de una referencia coherente
- Evita describir la misma organización con nombres o logotipos diferentes.
- Relaciona autor, proveedor, editor y sitio mediante identificadores estables.
- Facilita revisar el gráfico completo generado por Yoast u otra herramienta.
- Reduce duplicaciones al agregar entidades especializadas.
Propiedades requeridas, recomendadas y útiles
Schema.org define qué propiedades pueden utilizarse, pero una plataforma como Google puede establecer requisitos adicionales para una función concreta. Por eso hay que distinguir tres niveles:
Válidas en el vocabulario
La propiedad pertenece al tipo o puede heredarse de una jerarquía.
Requeridas por una función
Una plataforma puede exigir propiedades para considerar una presentación específica.
Útiles para la entidad
Propiedades verdaderas y mantenibles pueden describir mejor la entidad aunque no generen una función visible.
Schema.org en WordPress y Yoast SEO
Yoast SEO puede generar un gráfico con Organization o Person, WebSite, WebPage, Article y BreadcrumbList según el tipo de página y configuración. Añadir otro bloque completo sin inspeccionar el código puede crear entidades duplicadas.
Normalmente conviene conservar
- Los identificadores globales ya utilizados.
- El publisher y author coherentes.
- La relación WebPage y Article.
- BreadcrumbList cuando refleja la navegación.
Puede requerir complemento
- Service de una página comercial.
- Course de un curso real.
- Product y Offer de un producto.
- Event con datos visibles y actualizados.
La guía sobre páginas web WordPress explica requisitos generales de implementación y mantenimiento.
Errores frecuentes al elegir tipos y propiedades
Servicios, suscripciones y páginas de categorías pueden requerir una representación diferente.
Una página educativa no representa necesariamente un curso completo.
Cada bloque utiliza un @id, nombre, logo o dirección diferente para la misma entidad.
Un gráfico difícil de mantener puede reemplazarse por entidades identificadas y referenciadas.
Las migas representan jerarquía, no cualquier lista de artículos relacionados.
Se publican reseñas, precios, fechas o disponibilidad que no existen.
Quedan canonical, imágenes, identificadores y entidades pertenecientes a otra página.
Schema.org contiene más tipos que las funciones visuales admitidas por un buscador.
Checklist para seleccionar Schema.org
Esta lista funciona sin formularios ni JavaScript.
- Puedo explicar la función principal de la URL en una frase.
- Identifiqué la entidad principal y las secundarias.
- El tipo elegido representa exactamente la entidad.
- Las propiedades se aplican al tipo o se heredan correctamente.
- Los valores coinciden con el contenido visible.
- Las URLs, imágenes, fechas y nombres están actualizados.
- Reutilizo los @id de entidades ya existentes.
- No duplico el gráfico generado por Yoast.
- Separé validez de Schema.org y requisitos de Google.
- Puedo mantener la información después de publicar.
Prompt para evaluar tipos y propiedades con IA
Analiza el contenido visible que proporcionaré. No generes todavía código JSON-LD. No inventes precios, reseñas, fechas ni propiedades ausentes. Identifica: 1. La función principal de la URL. 2. La entidad principal y las entidades secundarias. 3. El tipo Schema.org más específico y fiel. 4. Las propiedades que pueden completarse con datos visibles. 5. Las entidades que deberían referenciarse mediante @id. 6. Posibles duplicaciones con Yoast o el tema. 7. Información faltante que debe resolverse antes de implementar. Separa vocabulario válido, requisitos de una función de Google y recomendaciones de mantenimiento.
¿No sabes qué entidades ya genera tu sitio?
Podemos revisar el gráfico actual, detectar tipos duplicados o contradictorios y definir qué marcado especializado necesita cada página.
Continúa la serie
Preguntas frecuentes sobre Schema.org
¿Qué es Schema.org?
Schema.org es un vocabulario que define tipos y propiedades para describir entidades y contenidos de forma estructurada, como organizaciones, artículos, productos, servicios, cursos y eventos.
¿Cuál es la diferencia entre un tipo y una propiedad?
El tipo clasifica la entidad, por ejemplo Service o Article. La propiedad describe un aspecto de esa entidad, como name, url, author, provider o image.
¿Cómo elijo el tipo de Schema correcto?
Resume la función principal de la URL, identifica la entidad central y elige el tipo más específico que la represente fielmente. Después comprueba que las propiedades coincidan con información visible y mantenible.
¿Puedo utilizar varios tipos en una misma página?
Sí. Una página puede relacionar varias entidades coherentes, como WebPage, Article, Organization y BreadcrumbList. Es preferible identificarlas y conectarlas antes que duplicarlas en bloques contradictorios.
¿Para qué sirve @id en los datos estructurados?
@id entrega un identificador estable a una entidad. Permite que otras entidades del gráfico se refieran a la misma organización, página, artículo, servicio o imagen sin volver a describirla de forma diferente.
¿Todos los tipos de Schema.org generan resultados enriquecidos?
No. Schema.org incluye un vocabulario amplio y los buscadores admiten funciones visibles solamente para determinados tipos y requisitos. Un marcado válido no garantiza una presentación enriquecida.
¿Qué Schema genera Yoast SEO?
Yoast puede generar entidades generales como Organization o Person, WebSite, WebPage, Article y BreadcrumbList según la configuración. Debes inspeccionar el código antes de añadir marcado personalizado.
¿Qué ocurre si utilizo el tipo equivocado?
El marcado puede describir incorrectamente la página, generar advertencias, ser ignorado o crear contradicciones con otras entidades. El tipo debe elegirse según el contenido real, no según el resultado deseado.