Skip to content

Update image.mdx with note on 'sizes' property - #89470

Closed
karlkeefer wants to merge 1 commit into
vercel:canaryfrom
karlkeefer:patch-3
Closed

Update image.mdx with note on 'sizes' property#89470
karlkeefer wants to merge 1 commit into
vercel:canaryfrom
karlkeefer:patch-3

Conversation

@karlkeefer

@karlkeefer karlkeefer commented Feb 4, 2026

Copy link
Copy Markdown
Contributor

Added note about the required sizes property for responsive resizing.

I was extremely surprised to discover responsive resizing doesn't happen without this property given the way the docs start.

The docs currently describe the component with this:

automatic image optimization

Followed by a code example that doesn't use sizes property and therefore doesn't get automatically optimized (other than 2x version).

I could also get behind including a sizes prop in the code example to at least invite people to read that detail buried in the docs. I might even argue that the default should be 100vw with responsive resizing, but that's probably a major breaking change for folks who expect the existing behavior.


Added note about the required 'sizes' property for responsive resizing.
@nextjs-bot nextjs-bot added the Documentation Related to Next.js' official documentation. label Feb 4, 2026
@nextjs-bot

Copy link
Copy Markdown
Contributor

Allow CI Workflow Run

  • approve CI run for commit: f0f1817

Note: this should only be enabled once the PR is ready to go and can only be enabled by a maintainer

@karlkeefer karlkeefer closed this by deleting the head repository Mar 26, 2026
@github-actions github-actions Bot locked as resolved and limited conversation to collaborators Apr 10, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

Documentation Related to Next.js' official documentation. locked

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants