Metadaten-Dateien API-Referenz

Dieser Abschnitt der Dokumentation behandelt Metadaten-Datei-Konventionen. Dateibasierte Metadaten können durch Hinzufügen spezieller Metadaten-Dateien zu Routensegmenten definiert werden.

Jede Dateikonvention kann entweder durch eine statische Datei (z.B. opengraph-image.jpg) oder eine dynamische Variante, die Code zur Dateierstellung verwendet (z.B. opengraph-image.js), definiert werden.

Sobald eine Datei definiert ist, wird Next.js die Datei automatisch bereitstellen (mit Hashes in der Produktion für Caching) und die relevanten Head-Elemente mit den korrekten Metadaten aktualisieren, wie z.B. die Asset-URL, Dateityp und Bildgröße.

Hinweis:

• Spezielle Route Handler wie sitemap.ts, opengraph-image.tsx und icon.tsx sowie andere Metadaten-Dateien werden standardmäßig gecacht.
• Bei Verwendung zusammen mit middleware.ts konfigurieren Sie den Matcher, um die Metadaten-Dateien auszuschließen.