Add ImageKit media hosting guide by imagekitio · Pull Request #13836 · withastro/docs

imagekitio · 2026-05-05T11:49:32Z

Adds a new media hosting guide for ImageKit alongside the existing Cloudinary and Mux guides.

What's added

src/content/docs/en/guides/media/imagekit.mdx — full guide covering installation, configuration, the image service, <Image /> / <Picture /> usage, AI-powered transformations (background removal, upscale, generative fill, drop shadow), the <Video /> component, the <OgImage /> component and getOgImageUrl() helper, client-side uploads (getUploadAuthParams + @imagekit/javascript), loading from the ImageKit Media Library via Astro Content Collections + @imagekit/nodejs, and Node.js asset management.
public/logos/imagekit.svg and a new entry in src/data/logos.ts (alphabetical, between image and juno).
Auto-registered in MediaGuidesNav via type: media frontmatter — no nav file edits needed.
i18nReady: false so the page is queued for translation by the community translators.

Small mentions added alongside Cloudinary

src/content/docs/en/guides/images.mdx — added a bullet under "Using Images from a CMS or CDN" mentioning the ImageKit Astro integration as a peer to the existing Cloudinary mention.
src/content/docs/en/reference/image-service-reference.mdx — added "ImageKit" to the list of example external image services (Cloudinary, Vercel, RIAPI).

Verification

pnpm astro check → 0 errors, 0 warnings on the new file.
pnpm build → 6268 pages built successfully.
Verified locally at /en/guides/media/ (card appears alphabetically) and /en/guides/media/imagekit/.
API surface (@imagekit/astro/integration, @imagekit/astro/server, getUploadAuthParams, OgImage, getOgImageUrl, Video, @imagekit/nodejs) cross-checked against the published ImageKit Astro integration docs.

- Adds src/content/docs/en/guides/media/imagekit.mdx with setup, image/video, OG image, client uploads, content-collection loader, and Node.js usage- Adds public/logos/imagekit.svg and registers it in src/data/logos.ts (alphabetically between image and juno)- Mentions ImageKit alongside Cloudinary in guides/images.mdx and reference/image-service-reference.mdx- Auto-registered in MediaGuidesNav via type: media frontmatter- i18nReady: false (translations to follow)

Co-authored-by: Copilot <copilot@github.com>

… to ImageKit guide Co-authored-by: Copilot <copilot@github.com>

netlify · 2026-05-05T11:49:37Z

✅ Deploy Preview for astro-docs-2 ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	`0945061`
🔍 Latest deploy log	https://app.netlify.com/projects/astro-docs-2/deploys/6a1add1f0a10840008cdb9df
😎 Deploy Preview	https://deploy-preview-13836--astro-docs-2.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

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

astrobot-houston · 2026-05-05T11:50:00Z

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

Here’s what will happen next:

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!
In a few minutes, you’ll be able to see a preview of your changes on Netlify 🥳.
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.

astrobot-houston · 2026-05-05T11:50:05Z

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/guides/images.mdx	Source changed, localizations will be marked as outdated.
en/guides/media/imagekit.mdx	Localization added, will be marked as complete.
en/reference/image-service-reference.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.

ArmandPhilippot

Thank you for your contribution, and for your patience! Between the minor releases and planning Astro 7, we're falling a bit behind on the reviews...

I left a few suggestions to match our writing style (i.e. too much "so", we try to be more direct) and to be clearer when the user is redirected to an external website. But, overall, this looks good to me!

Co-authored-by: Armand Philippot <git@armand.philippot.eu>

…documentation

imagekitio · 2026-05-21T10:37:44Z

Thank you for your contribution, and for your patience! Between the minor releases and planning Astro 7, we're falling a bit behind on the reviews...

I left a few suggestions to match our writing style (i.e. too much "so", we try to be more direct) and to be clearer when the user is redirected to an external website. But, overall, this looks good to me!

Thanks @ArmandPhilippot for taking the time to review this and suggest edits. I’ve applied all the suggestions and also added a new section about the ImageKit Video Player. We recently introduced an Astro-specific export for that package, so I included it as well.

ArmandPhilippot

Thanks for the update! I left two suggestions: one nit and a paragraph that I find too long to be easy to read. But, otherwise this looks good to me!

cc @yanthomasdev when you have the time, I think this is ready for another look!

yanthomasdev

Thanks, I have one small nit. Once Armand's suggestions are applied as well this should be good to go.

manu4543 · 2026-05-28T07:26:00Z

@yanthomasdev @ArmandPhilippot Thanks for the inputs and help so far. Accepted all edits.

ArmandPhilippot

Thank you for this new guide and your support! 💜

Co-authored-by: Manu Chaudhary <manu@imagekit.io> Co-authored-by: Armand Philippot <git@armand.philippot.eu> Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>

manu4543 and others added 3 commits May 5, 2026 16:16

docs(images): enhance ImageKit integration details in images guide

de8da01

Co-authored-by: Copilot <copilot@github.com>

docs(images): add AI-powered transformations and upload form examples…

069f07d

… to ImageKit guide Co-authored-by: Copilot <copilot@github.com>

ArmandPhilippot reviewed May 15, 2026

View reviewed changes

ArmandPhilippot added add new content Document something that is not in docs. May require testing, confirmation, or affect other pages. 3rd-party guide Community submitted CMS, deploy, backend etc. guide labels May 15, 2026

imagekitio and others added 14 commits May 21, 2026 15:43

Update src/content/docs/en/guides/media/imagekit.mdx

ff109dc

Co-authored-by: Armand Philippot <git@armand.philippot.eu>

Update src/content/docs/en/guides/media/imagekit.mdx

dd5119b

Co-authored-by: Armand Philippot <git@armand.philippot.eu>

Update src/content/docs/en/guides/media/imagekit.mdx

daa2e88

Co-authored-by: Armand Philippot <git@armand.philippot.eu>

Update src/content/docs/en/guides/media/imagekit.mdx

bdf79ce

Co-authored-by: Armand Philippot <git@armand.philippot.eu>

Update src/content/docs/en/guides/images.mdx

638bd57

Co-authored-by: Armand Philippot <git@armand.philippot.eu>

Update src/content/docs/en/guides/media/imagekit.mdx

af539a9

Co-authored-by: Armand Philippot <git@armand.philippot.eu>

Update src/content/docs/en/guides/media/imagekit.mdx

eba1982

Co-authored-by: Armand Philippot <git@armand.philippot.eu>

Update src/content/docs/en/guides/media/imagekit.mdx

2da760a

Co-authored-by: Armand Philippot <git@armand.philippot.eu>

Update src/content/docs/en/guides/media/imagekit.mdx

15d86f9

Co-authored-by: Armand Philippot <git@armand.philippot.eu>

Update public/logos/imagekit.svg

dcff9ef

Co-authored-by: Armand Philippot <git@armand.philippot.eu>

Update src/content/docs/en/guides/media/imagekit.mdx

6c2077c

Co-authored-by: Armand Philippot <git@armand.philippot.eu>

Update src/content/docs/en/guides/media/imagekit.mdx

7b07377

Co-authored-by: Armand Philippot <git@armand.philippot.eu>

Add ImageKit Video Player integration and usage instructions

90be45d

Clarify AI subtitle generation and chapter detection in Video Player …

65ad937

…documentation

ArmandPhilippot reviewed May 21, 2026

View reviewed changes

Comment thread src/content/docs/en/guides/media/imagekit.mdx Outdated

Comment thread src/content/docs/en/guides/media/imagekit.mdx Outdated

yanthomasdev reviewed May 22, 2026

View reviewed changes

Comment thread src/content/docs/en/guides/media/imagekit.mdx Outdated

docs(imagekit.mdx): address review comments

8ea335d

ArmandPhilippot approved these changes May 30, 2026

View reviewed changes

Merge branch 'main' into add-imagekit-media-guide

0945061

ArmandPhilippot merged commit 19549bc into withastro:main May 30, 2026
12 checks passed

jsparkdev mentioned this pull request Jun 2, 2026

i18n(ko-KR): update images, image-service-reference, add imagekit #13965

Merged

This was referenced Jun 2, 2026

i18n(fr): add guides/media/imagekit.mdx #13966

Merged

i18n(fr): update guides/images.mdx & image-service-reference.mdx #13967

Merged

Uh oh!

Uh oh!

Conversation

imagekitio commented May 5, 2026

Uh oh!

netlify Bot commented May 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for astro-docs-2 ready!

Uh oh!

astrobot-houston commented May 5, 2026

Uh oh!

astrobot-houston commented May 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Lunaria Status Overview

Tracked Files

Uh oh!

ArmandPhilippot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

imagekitio commented May 21, 2026

Uh oh!

ArmandPhilippot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

yanthomasdev left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

manu4543 commented May 28, 2026

Uh oh!

ArmandPhilippot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

netlify Bot commented May 5, 2026 •

edited

Loading

astrobot-houston commented May 5, 2026 •

edited

Loading