Generador de schema de recetas

Cómo generar el schema de recetas

Recipe tiene más propiedades que se condicionan entre sí que cualquier otro tipo habitual. El generador escribe el marcado y la ficha con los mismos valores e informa de cada contradicción que ve.

1. Nombra el plato y añade una foto. Las dos cosas son obligatorias. La foto es del plato terminado y su URL tiene que poder rastrearse; Google sugiere varias proporciones de la misma imagen.
2. Da los tiempos en pareja. O un tiempo total, o preparación y cocción juntas. Escríbelos como te salga —15 min, 1 hora y 30 minutos, 1,5 h—; la salida es ISO 8601 en cualquier caso.
3. Ata las calorías a las raciones. Las calorías son por ración, así que sin número de raciones el dato está incompleto. El generador lo trata como error porque Google lo exige en una frase.
4. Escribe ingredientes y pasos en líneas. Un ingrediente por línea y un paso por línea. Cada paso se convierte en un HowToStep, que Google prefiere a un bloque de texto que tenga que partir por su cuenta.
5. Pega las dos salidas. El JSON-LD va en la página de la receta. La ficha lleva los mismos ingredientes y los mismos pasos, que aquí importa más que en ningún sitio: son los textos que muestra Google.

Los tres tiempos y qué combinaciones valen

Un generador de schema de recetas convierte una receta en JSON-LD de Recipe: los datos estructurados de recetas que Google lee para los ingredientes, la elaboración, los tiempos y la información nutricional. Solo hay dos propiedades obligatorias, name e image. Lo interesante pasa entre las opcionales, porque varias solo son válidas acompañadas.

De cookTime y de prepTime, la documentación de Google dice lo mismo: úsalos siempre en combinación. De totalTime: usa totalTime o una combinación de cookTime y prepTime. Así que hay dos formas legales y una ilegal muy común:

Los tres llevan duraciones ISO 8601 —PT1H30M, no «hora y media»—. Este formulario acepta lo que tengas en la cabeza: los símbolos que la norma española de unidades reconoce para el tiempo (15 min, 1 h 30 min), las palabras (1 hora y 30 minutos), la coma decimal (1,5 h son 90 minutos), 1h30, 1:30, 90 o la forma ISO. Lo único que no adivina es un decimal sin unidad: 1,5 igual son minutos que horas, así que lo rechaza.

Y algo que no es regla de Google, aunque se repita: totalTime no tiene por qué ser la suma de prepTime y cookTime. En el ejemplo, los diez minutos de reposo de la patata en el huevo van en el total y en ningún otro. El formulario solo avisa cuando el total es menor que la suma, porque eso es aritmética, no política, y suele ser una errata.

Gramos, mililitros y cucharadas: los ingredientes como se escriben aquí

El ejemplo de ingredientes de la documentación de Google, también en su versión en español, está en onzas y tazas: "3/4 cup sugar". Una receta española se escribe en gramos y mililitros, y la norma de unidades legales, el Real Decreto 2032/2009, dice cómo:

• Los símbolos no son abreviaturas. No llevan punto ni plural: 200 g, no «200 grs.» ni «200 gr.».
• Entre el número y el símbolo va un espacio: 250 ml, no «250ml».
• El litro admite L o l, y la norma recomienda la mayúscula para no confundirla con un 1. Y abreviaturas como «cc» no están permitidas: son mililitros.

Las medidas de casa —una cucharada, una cucharadita, una pizca— son texto y valen tal cual. Lo que pide Google es otra cosa: incluye solo el texto del ingrediente que sea necesario para hacer la receta, sin definiciones. Cada línea del formulario es un recipeIngredient, y el generador junta los espacios repetidos antes de escribirla.

Revisamos el marcado de cuatro recetas de tortilla de patatas de tres recetarios españoles el 26 de septiembre de 2026. En una, cuatro de los cinco ingredientes llevaban «count» pegado a la cantidad («5count Patatas»); en otra, un ingrediente traía un enlace HTML dentro; y otra no tenía ningún tiempo. Eso es lo que lee Google, por bien escrita que esté la página.

Calorías, raciones y palabras clave: datos que van juntos o no van

La línea de Google sobre nutrición es corta: si defines nutrition.calories, también debes indicar con recipeYield el número de porciones. Y de recipeYield: la cantidad de porciones, expresada con un número; otras unidades pueden ir como resultados adicionales. Unas calorías sin saber cuántas raciones salen no informan de nada, y por eso este generador trata la falta de raciones como error y no como aviso.

"recipeYield": "4"
      "nutrition": { "@type": "NutritionInformation", "calories": "440 calories" }

El valor de calories es de tipo Energy, que schema.org define como un número seguido de su unidad; el ejemplo de Google usa "120 calories", y este formulario solo comprueba que haya un número.

Las palabras clave tienen su propia disciplina: sirven para términos de más —la temporada («verano»), una fiesta («Navidad»), «rápido», «fácil»—, no para repetir otras propiedades. Google lo pone por escrito: no uses una etiqueta que sea recipeCategory o recipeCuisine. En tres de las cuatro recetas que revisamos, keywords repetía la categoría o la gastronomía, con valores como «Cocina española» presentes también en recipeCuisine. El formulario avisa de cada palabra clave que coincide con una de las dos.

Los pasos: HowToStep, y nada que no sea el paso

Hay tres formas de escribir recipeInstructions, y no valen lo mismo. Con un bloque de texto, Google intenta partir la elaboración en pasos por su cuenta y quitar números de paso y títulos de sección; para obtener los mejores resultados, recomienda especificar los pasos sin ambigüedad con HowToStep. HowToStep dice sin ambigüedad dónde empieza cada paso. HowToSection agrupa pasos cuando la receta tiene partes de verdad (masa, relleno, glaseado). Una de las cuatro recetas que revisamos entregaba la elaboración entera como un solo bloque, con los asteriscos de negrita dentro.

Este generador escribe un HowToStep por línea, y la instrucción que va con ellos está en la documentación de Google en español: incluye solo texto sobre cómo hacer el plato y no otro tipo de texto como «Indicaciones», «Echa un vistazo al vídeo» o «Paso 1». La numeración la da la posición en la lista. El formulario avisa cuando un paso empieza por uno de esos rótulos, en español («Paso 1», «Indicaciones», «Echa un vistazo al vídeo») o en inglés («Step 1», «Directions», «Watch the video»).

Una receta suele pedir después dos cosas más. Las valoraciones siguen las directrices de fragmentos de reseña, y en una receta con una sola reseña el autor tiene que ser una persona u organización válida: el ejemplo de Google de lo que no vale es «50 % de descuento en ingredientes». Y el vídeo es un VideoObject completo, con miniatura estable y fecha de subida con zona horaria. Las dos cosas tienen su herramienta: el generador de schema de reseñas y el generador de schema de vídeo.