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, managed from a Cache Files admin page
Copy Resolution setting — choose the resolution used when copying originals into the media library
Test Connection — verify your server URL and API key from the Settings page before saving

This plugin also ships an “Immich Album Gallery” block: insert it in any post, pick an Immich album, and the post renders a live gallery of that album using the core Gallery markup (so it inherits your theme’s styling and works with the WordPress core lightbox).

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.

Media Picker for Immich

External services

What data is sent and when

Immich project links