Referencia de la API de archivos de metadatos
Esta sección de la documentación cubre las convenciones de archivos de metadatos. Los metadatos basados en archivos pueden definirse añadiendo archivos especiales de metadatos a segmentos de ruta.
Cada convención de archivo puede definirse usando un archivo estático (ej. opengraph-image.jpg
), o una variante dinámica que utiliza código para generar el archivo (ej. opengraph-image.js
).
Una vez definido un archivo, Next.js lo servirá automáticamente (con hashes en producción para caché) y actualizará los elementos relevantes del head con los metadatos correctos, como la URL del recurso, tipo de archivo y tamaño de imagen.
Es bueno saber:
- Los Manejadores de Ruta especiales como
sitemap.ts
,opengraph-image.tsx
, yicon.tsx
, y otros archivos de metadatos se almacenan en caché por defecto.- Si se usan junto con
middleware.ts
, configure el matcher para excluir los archivos de metadatos.
favicon, icon y apple-icon
Referencia de API para las convenciones de archivos Favicon, Icon y Apple Icon.
manifest.json
Referencia de API para el archivo manifest.json.
opengraph-image y twitter-image
Referencia de API para las convenciones de archivos de imágenes Open Graph y Twitter.
robots.txt
Referencia de API para el archivo robots.txt.
sitemap.xml
Referencia de API para el archivo sitemap.xml.