@@ -306,6 +307,8 @@ const { post } = Astro.props;
with `src` and `alt` -- writing `` renders `[object Object]`.
+Use `priority` only for the likely above-the-fold image on a page, such as a hero or first card image. It renders the image with `loading="eager"` and `fetchpriority="high"`. `loading` controls whether the browser may defer loading, while `fetchpriority` hints how important the request is once the browser discovers it.
+
## Using Menus
Query admin-defined menus in your layouts. Never hard-code navigation links:
diff --git a/packages/core/src/components/EmDashImage.astro b/packages/core/src/components/EmDashImage.astro
index 710c58974..2d828053f 100644
--- a/packages/core/src/components/EmDashImage.astro
+++ b/packages/core/src/components/EmDashImage.astro
@@ -170,6 +170,7 @@ const imgProps: Record = {
height: finalHeight,
alt: finalAlt,
loading: priority ? "eager" : "lazy",
+ fetchpriority: priority ? "high" : undefined,
decoding: "async",
style: placeholderStyle ? `${baseStyle} ${placeholderStyle}` : baseStyle,
...attrs,