Media Picker for Immich
Adds an “Immich” tab to the WordPress media picker modal and the Media Library grid view. Search and browse your self-hosted Immich photo library, then import selected photos directly into WordPress or proxy them without copying files.
Features:
- Use or Copy — “Use” proxies media directly from Immich (no files copied); “Copy” downloads the original into the media library
- Photo and video support — images are proxied with full-resolution originals; videos stream with seeking support
- Smart search — find media using Immich’s AI-powered search
- People filter — browse by recognized people from your Immich library
- Multi-select — use or import multiple items at once with infinite scroll
- Lightbox — full-resolution lightbox on Immich images in posts
- Media Library integration — browse and import Immich assets directly from the Media Library grid view
- Previously added — the Immich tab shows assets you’ve already used, ready to re-select
- Secure API proxy — all Immich API calls happen server-side; the API key is never exposed to the browser
- Per-user API keys — each user can configure their own Immich API key
- Local proxy cache — proxied media is cached on disk after the first request; optional automatic cleanup with configurable lifetime
External services
This plugin connects to a self-hosted Immich server that you configure in Settings > Immich. Immich is a self-hosted photo and video management solution — it runs on your own infrastructure and is not a third-party cloud service, but the connection is disclosed here for transparency.
What data is sent and when
- Browsing and searching: When a logged-in WordPress user opens the Immich media picker or searches for photos, the plugin sends API requests (search queries, page numbers, and person filter IDs) to your Immich server.
- Importing or using media: When a user selects an asset to import or use, the plugin fetches the original file or metadata from the Immich server using the asset’s UUID.
- Proxying media to visitors: When a site visitor views a page containing Immich-proxied images or videos, WordPress fetches the media from your Immich server on their behalf. Visitor data is not sent to Immich — only the stored asset UUID and your API key are used server-side.
All communication uses the API key you configure in WordPress. The API key is never exposed to browsers.
Immich project links
Since Immich is self-hosted, the terms of use and privacy practices are determined by whoever operates the Immich server you connect to.