Donncha O Caoimh (a11n)

Adds an “Immich” tab to the WordPress media picker modal and the Media Library grid view. Search and browse your self-hosted <a href="https://immich.app/" rel="nofollow ugc">Immich</a> photo library, then import selected photos directly into WordPress or proxy them without copying files.
Features:
<ul>
<li>Use or Copy — “Use” proxies media directly from Immich (no files copied); “Copy” downloads the original into the media library</li>
<li>Photo and video support — images are proxied with full-resolution originals; videos stream with seeking support</li>
<li>Smart search — find media using Immich’s AI-powered search</li>
<li>People filter — browse by recognized people from your Immich library</li>
<li>Multi-select — use or import multiple items at once with infinite scroll</li>
<li>Lightbox — full-resolution lightbox on Immich images in posts</li>
<li>Media Library integration — browse and import Immich assets directly from the Media Library grid view</li>
<li>Previously added — the Immich tab shows assets you’ve already used, ready to re-select</li>
<li>Secure API proxy — all Immich API calls happen server-side; the API key is never exposed to the browser</li>
<li>Per-user API keys — each user can configure their own Immich API key</li>
<li>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</li>
<li>Copy Resolution setting — choose the resolution used when copying originals into the media library</li>
<li>Test Connection — verify your server URL and API key from the Settings page before saving</li>
</ul>
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).
<h3>External services</h3>
This plugin connects to a self-hosted <a href="https://immich.app/" rel="nofollow ugc">Immich</a> 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.
<h4>What data is sent and when</h4>
<ul>
<li>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.</li>
<li>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.</li>
<li>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.</li>
</ul>
All communication uses the API key you configure in WordPress. The API key is never exposed to browsers.
<h4>Immich project links</h4>
<ul>
<li><a href="https://immich.app/" rel="nofollow ugc">Immich website</a></li>
<li><a href="https://immich.app/privacy-policy" rel="nofollow ugc">Immich privacy policy</a></li>
<li><a href="https://github.com/immich-app/immich/blob/main/LICENSE" rel="nofollow ugc">Immich license (AGPL-3.0)</a></li>
</ul>
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

Use photos and videos from your Immich server in WordPress without copying files, or import them into the media library.

sietsevisser

Gallery for Immich is a WordPress plugin that seamlessly integrates your self-hosted Immich photo server with your WordPress site. Display beautiful photo galleries and albums using simple shortcodes.
Key Features:
<ul>
<li>Gutenberg Block Editor – Visual block for selecting albums, photos and settings</li>
<li>Shortcode Support – Classic <code>[gallery_for_immich]</code> shortcode for any editor</li>
<li>Display list of albums from Immich</li>
<li>Display entire albums from Immich</li>
<li>Beautiful responsive grid layouts</li>
<li>Integrated lightbox with GLightbox</li>
<li>Video playback modes (shared links, proxy via fopen, or ignore videos)</li>
<li>Flexible sorting options (date/name, ascending/descending)</li>
<li>Single photo embedding – Display one photo with alignment (left/right/center) and configurable link behavior (lightbox, no link, or custom URL)</li>
<li>Full internationalization support (Dutch, German, French translations)</li>
<li>Configure Immich server URL and API key in the WordPress admin panel</li>
</ul>
Perfect for:
<ul>
<li>Photography portfolios</li>
<li>Family photo sharing</li>
<li>Event galleries</li>
<li>Travel blogs</li>
<li>Any self-hosted photo management with Immich</li>
</ul>
<h3>Usage</h3>
Using the Gutenberg Block Editor:
The easiest way to add an Immich gallery is through the Gutenberg block editor:
<ol>
<li>Add a new block and search for “Gallery for Immich”</li>
<li>Select your display mode (all albums, single album, multiple albums, or single photo)</li>
<li>Configure display options using the sidebar controls</li>
<li>Customize thumbnail size and text sizes as needed</li>
<li>The preview shows the shortcode that will be used</li>
</ol>
Using Shortcodes:
You can also use shortcodes directly in your content:
Display all albums: 
 [gallery_for_immich]
Display specific albums (comma-separated IDs): 
 [gallery_for_immich albums=”album-id-1,album-id-2″]
Display single album: 
 [gallery_for_immich album=”album-id”]
Display single photo: 
 [gallery_for_immich asset=”photo-id”]
Customize display options: 
 [gallery_for_immich show=”gallery_name,asset_description”]
Available show options (no defaults – must be explicitly specified): 
* <code>gallery_name</code> – Show album/gallery name 
* <code>gallery_description</code> – Show album description 
* <code>asset_date</code> – Show photo date 
* <code>asset_description</code> – Show photo description
Note: If the <code>show</code> parameter is not specified, only thumbnails are displayed without any text.
Customize sizes: 
 [gallery_for_immich size=”300″ title_size=”18″ description_size=”15″ date_size=”12″]
Size options: 
* <code>size</code> – Thumbnail size for albums (100-500, default: 200); max-width for single photos (100-1200, default: 200) 
* <code>title_size</code> – Title font size (10-30, default: 16) 
* <code>description_size</code> – Description font size (10-30, default: 14) 
* <code>date_size</code> – Date font size (10-30, default: 13)
Single photo alignment and link behavior: 
 [gallery_for_immich asset=”photo-id” align=”left” link=”none”] 
 [gallery_for_immich asset=”photo-id” align=”right” link=”https://example.com”]
Align options: <code>left</code>, <code>right</code>, <code>center</code> (default: no float) 
Link options: <code>lightbox</code> (default — opens in overlay), <code>none</code> (no link), or any <code>https://...</code> URL (opens in new tab)
Sort order: 
 [gallery_for_immich order=”date_desc”] 
 [gallery_for_immich album=”album-id” order=”description_asc”]
Available order options: 
* <code>date_desc</code> – Newest first (default for albums) 
* <code>date_asc</code> – Oldest first (default for photos – chronological order) 
* <code>name_asc</code> – Alphabetically A-Z (albums only) 
* <code>name_desc</code> – Alphabetically Z-A (albums only) 
* <code>description_asc</code> – Alphabetically A-Z by description (photos only) 
* <code>description_desc</code> – Alphabetically Z-A by description (photos only)
Note: Name sorting is only available for albums. Photos can be sorted by date or description.
<h3>Privacy & Security</h3>
This plugin: 
* Connects to your self-hosted Immich server via API 
* Does not collect or transmit any user data to third parties 
* Requires HTTPS for production security 
* Validates all user input and API parameters 
* Uses WordPress security best practices
Your Immich server credentials (URL and API key) are stored in your WordPress database.
<h3>Support</h3>
For issues, feature requests, or contributions, please visit: 
https://github.com/vogon1/immich-wordpress-plugin
<h3>Credits</h3>
<ul>
<li>Lightbox powered by GLightbox (https://github.com/biati-digital/glightbox)</li>
<li>Integrates with Immich (https://immich.app)</li>
</ul>

Gallery for Immich

Display your Immich photo albums and galleries in WordPress using simple shortcodes.

Media Picker for Immich vs Gallery for Immich