Skip to content

docs(astro-assets): clarify getImage() options don't match all Image props#13786

Open
nielskaspers wants to merge 1 commit intowithastro:mainfrom
nielskaspers:docs/issue-13301-getimage-props
Open

docs(astro-assets): clarify getImage() options don't match all Image props#13786
nielskaspers wants to merge 1 commit intowithastro:mainfrom
nielskaspers:docs/issue-13301-getimage-props

Conversation

@nielskaspers
Copy link
Copy Markdown

Summary

The reference docs state that `getImage()` takes an options object with "the same properties as the Image component (except `alt`)". That isn't accurate: `getImage()` accepts `UnresolvedImageTransform`, which does not include `priority` or `layout` either — those are ``-only props.

The same wording was duplicated in the `LocalImageService` / `ExternalImageService` `getImage()` entry, so both are updated.

Issue

Fixes #13301

Changes

  • `src/content/docs/en/reference/modules/astro-assets.mdx`: reword the two `getImage()` descriptions to say "a subset of the Image component properties (excluding `alt`, `priority`, and `layout`)".

Testing

  • Docs-only change; no code or configuration touched.

…props

The getImage() description claimed options match the Image component
properties "except alt", but getImage() accepts UnresolvedImageTransform,
which also omits priority and layout (Image-only props). Same wording
was used for LocalImageService/ExternalImageService `getImage()`.

Closes withastro#13301
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 22, 2026

Deploy Preview for astro-docs-2 ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit abf5884
🔍 Latest deploy log https://app.netlify.com/projects/astro-docs-2/deploys/69e866b9db70670008133122
😎 Deploy Preview https://deploy-preview-13786--astro-docs-2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@astrobot-houston
Copy link
Copy Markdown
Contributor

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File Note
en/reference/modules/astro-assets.mdx Source changed, localizations will be marked as outdated.
Warnings reference
Icon Description
🔄️ The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

@astrobot-houston
Copy link
Copy Markdown
Contributor

Hello! Thank you for opening your first PR to Astro’s Docs! 🎉

Here’s what will happen next:

  1. Our GitHub bots will run to check your changes.
    If they spot any broken links you will see some error messages on this PR.
    Don’t hesitate to ask any questions if you’re not sure what these mean!

  2. In a few minutes, you’ll be able to see a preview of your changes on Netlify 🥳.

  3. One or more of our maintainers will take a look and may ask you to make changes.
    We try to be responsive, but don’t worry if this takes a few days.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Incorrect description of UnresolvedImageTransform in getImage()

2 participants