Why this matters
Large images can make otherwise fast static pages feel slow. They also affect Core Web Vitals and reader experience on mobile.
Setup
Choose consistent image dimensions for article hero images and inline examples. Write descriptive alt text that explains the image purpose, not just keywords.
Implementation notes
Prefer local optimized assets when images are part of evergreen content. Avoid using oversized screenshots in long tutorials unless the detail is necessary.
Final checklist
- Images have useful alt text
- Large assets are compressed
- Layout shift is avoided