Metadata Files API Reference

This section of the docs coversMetadata file conventions. File-based metadata can be defined by adding special metadata files to route segments.

Each file convention can be defined using a static file (e.g.opengraph-image.jpg), or a dynamic variant that uses code to generate the file (e.g.opengraph-image.js).

Once a file is defined, Next.js will automatically serve the file (with hashes in production for caching) and update the relevant head elements with the correct metadata, such as the asset's URL, file type, and image size.

Good to know:

• Special Route Handlers likesitemap.ts,opengraph-image.tsx, andicon.tsx, and othermetadata files are cached by default.
• If using along withmiddleware.ts,configure the matcher to exclude the metadata files.