Gallery for Immich
Display your Immich photo albums and galleries in WordPress using simple shortcodes.
Solid choice
Gallery for Immich is a solid plugin choice in 2026, with a few things worth checking first. It runs on 100+ sites, is rated 5/5 and was last updated 3 weeks ago, and scores 75/100 on our health check.
- Actively developed — last update 3 weeks ago
- Tested with the latest WordPress (7.1)
- Small user base (100+ active installs)
- Very few reviews so far
How does it stack up?
Side-by-side on installs, updates, ratings & support
Daily downloads
Download spikes usually follow a new release — each site that auto-updates counts as a download.
Rankings
Where Gallery for Immich stands todayWordPress.org search rankings
Live position in the plugin search, top 100| Keyword | Position |
|---|---|
| albums | #29 |
| gallery | #75 |
| immich | #1 |
| lightbox | >100 |
| photos | >100 |
Version adoption
Share of active sites per release.
Rating breakdown
★★★★★★★★★★ 5 from 2 reviews
About Gallery for Immich
From the official readme · v0.9.0Description
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:
- Gutenberg Block Editor – Visual block for selecting albums, photos and settings
- Shortcode Support – Classic
[gallery_for_immich]shortcode for any editor - Display list of albums from Immich
- Display entire albums from Immich
- Beautiful responsive grid layouts
- Integrated lightbox with GLightbox
- Video playback modes (shared links, proxy via fopen, or ignore videos)
- Flexible sorting options (date/name, ascending/descending)
- Limit the number of albums or photos shown, either the first ones or a random selection
- Single photo embedding – Display one photo with alignment (left/right/center) and configurable link behavior (lightbox, no link, or custom URL)
- Full internationalization support (Dutch, German, French translations)
- Configure Immich server URL and API key in the WordPress admin panel
Perfect for:
- Photography portfolios
- Family photo sharing
- Event galleries
- Travel blogs
- Any self-hosted photo management with Immich
Usage
Using the Gutenberg Block Editor:
The easiest way to add an Immich gallery is through the Gutenberg block editor:
- Add a new block and search for “Gallery for Immich”
- Select your display mode (all albums, single album, multiple albums, or single photo)
- Configure display options using the sidebar controls
- Customize thumbnail size and text sizes as needed
- The preview shows the shortcode that will be used
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):
* gallery_name – Show album/gallery name
* gallery_description – Show album description
* asset_date – Show photo date
* asset_description – Show photo description
Note: If the show parameter is not specified, only thumbnails are displayed without any text.
Different texts on the album page:
[gallery_for_immich show=”gallery_name” detail_show=”gallery_name,gallery_description,asset_date”]
When a visitor clicks an album in an overview, the album opens with the same show options. detail_show sets different options for that album page, using the same values as show. detail_show="" shows no text there; without detail_show, show applies to both.
Customize sizes:
[gallery_for_immich size=”300″ title_size=”18″ description_size=”15″ date_size=”12″]
Size options:
* size – Thumbnail size for albums (100-500, default: 200); max-width for single photos (100-1200, default: 200)
* title_size – Title font size (10-30, default: 16)
* description_size – Description font size (10-30, default: 14)
* date_size – 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: left, right, center (default: no float)
Link options: lightbox (default — opens in overlay), none (no link), or any https://... URL
Link target (custom URL only): new (default — opens in a new tab) or same (opens in the current tab)
[gallery_for_immich asset=”photo-id” link=”https://example.com/page” link_target=”same”]
Sort order:
[gallery_for_immich order=”date_desc”]
[gallery_for_immich album=”album-id” order=”description_asc”]
Available order options:
* date_desc – Newest first (default for albums)
* date_asc – Oldest first (default for photos – chronological order)
* name_asc – Alphabetically A-Z (albums only)
* name_desc – Alphabetically Z-A (albums only)
* description_asc – Alphabetically A-Z by description (photos only)
* description_desc – Alphabetically Z-A by description (photos only)
Note: Name sorting is only available for albums. Photos can be sorted by date or description.
Limit the number of albums or photos:
[gallery_for_immich album=”album-id” limit=”10″ order=”date_desc”]
[gallery_for_immich limit=”3″ pick=”random”]
limit– Maximum number of albums (overview) or photos (album), 1-1000. Omit to show all.pick–first(default) takes the first ones in the sort order;randomshows a random selection, still displayed in the sort order
For albums sorted by date, or with pick="random", only the requested photos are fetched from Immich. An album opened from a limited overview still shows all of its photos.
Show the latest photo of an album, linking to your gallery page:
[gallery_for_immich album=”album-id” limit=”1″ order=”date_desc” link=”https://example.com/gallery” link_target=”same”]
link and `link_target` work for albums with the same values as for single photos. A custom URL applies to every photo in the album; album overviews are not affected.<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.
Support
For issues, feature requests, or contributions, please visit:
https://github.com/vogon1/immich-wordpress-plugin
Credits
- Lightbox powered by GLightbox (https://github.com/biati-digital/glightbox)
- Integrates with Immich (https://immich.app)
Installation
- Install via WordPress admin: Plugins > Add New > Search for “Gallery for Immich”
- Click “Install Now” and then “Activate”
- Or upload the plugin files to
/wp-content/plugins/gallery-for-immich/directory and activate through the ‘Plugins’ menu
Configuration:
After activation, configure your Immich server connection:
Step 1: Create an Immich API Key
- Log in to your Immich server with the user account whose photos you want to display
- Go to Account Settings (click your profile picture in the top right)
- Navigate to API Keys tab
- Click New API Key
- Give it a descriptive name (e.g., “WordPress Plugin”)
- Set the following minimum required permissions:
album.read– Required to list and view albumsasset.read– Required to access photo metadata (EXIF data, descriptions, dates)asset.view– Required to retrieve photo thumbnailssharedLink.create– Required when using video mode ‘Shared Link’sharedLink.delete– Required when using video mode ‘Shared Link’
- Important: Only grant read-only access. Never grant write permissions for security reasons.
Note: Shared links can only be created for photos and videos this Immich user owns. If you use a separate display account with albums shared to it, choose a different video mode (see below). - Click Create and copy the generated API key
Step 2: Configure the Plugin in WordPress
- Navigate to Settings > Gallery for Immich in your WordPress admin
- Enter your Immich server URL (e.g., https://immich.example.com)
- Paste the API key you created in Step 1
- Choose Video playback mode (shared links, proxy via fopen, or ignore videos)
- Save changes
Video playback modes:
- Shared links (default) – Creates temporary shared links on Immich. Videos stream directly from Immich and links expire automatically. Requires that the API key’s Immich user owns the videos; this mode does not work for albums that are only shared with that user.
- Proxy via fopen – Streams videos through WordPress. Most elegant solution, but requires
fopensupport on the WordPress server which is not always supported. - Ignore videos – Hides videos in galleries and only shows photos.
Frequently asked questions
What is Immich?
Immich is a self-hosted photo and video backup solution. Learn more at https://immich.app
Do I need my own Immich server?
Yes, this plugin requires a running Immich server with API access.
How do I find my album or photo IDs?
You can find IDs in your Immich server’s URL when viewing albums or photos, or through the Immich API.
Does this work with localhost?
Yes, for development purposes localhost URLs (http://localhost or http://127.0.0.1) are allowed. Production servers must use HTTPS.
Can I use a separate Immich account instead of the owner account?
Yes. You can create a secondary Immich account, share the albums you want to publish with it, and use that account’s API key. This keeps your main account’s credentials off the WordPress server. One limitation: Immich only allows shared links to be created for assets a user actually owns, not for assets that are merely shared with them. Photos work normally, but videos in the default ‘Shared links’ video mode will not play for such a display account. Choose ‘Proxy via fopen’ or ‘Ignore videos’ instead. The connection & permissions test on the settings page detects this situation and explains…
Can I customize the appearance?
Yes, the plugin generates standard HTML with CSS classes. You can override styles in your theme’s CSS.
Is the plugin translated?
Yes, the plugin is fully internationalized and includes translations for: * Dutch (nl_NL) – Nederlands * German (de_DE) – Deutsch * French (fr_FR) – Français Additional translations can be contributed via .po files in the languages directory.
Changelog
Adds photo limits, random selection, separate album-page texts and link options for albums, plus security hardening. Using a page cache? Clear it after updating so Live Photos keep working.
0.9.0
Release Date – 24 September 2026
- Tested against WordPress 7.1.2 and Immich v3.2.2
- New:
limit=andpick=— show only a number of albums or photos, the first ones in the sort order or a random selection. For albums sorted by date, or withpick="random", only the requested photos are fetched from Immich (issue #13) - New:
detail_show=— choose different texts for the album page that opens when a visitor clicks an album in an overview - New:
link=also works for albums, so e.g. the latest photo of an album can link to your full gallery page - New:
link_target=— open a custom link in the same tab or a new tab (default) (issue #6) - Improved: the block editor only offers the sort options that apply to the chosen display mode, and explains that “Multiple albums” keeps the order in which you select them
- Security: an album page opened from a URL is now limited to the albums the shortcode actually shows
- Security: the Live Photo endpoint only serves videos of photos shown on the site, and shared links for videos are reused instead of created on every page view
- Security: the image proxy no longer serves original files, and only streams videos in the “Proxy via fopen” mode
- Fix: block editor translations could fall back to an older version after a build
0.8.2
Release Date – 3 September 2026
- Tested against WordPress 7.1 and Immich v3.1
- Fix: Photos rotated, cropped or filtered in Immich showed their original, unedited version. The plugin now requests the edited render (
edited=true, Immich v2.5+) (issue #15) - Fix: Edited photos stayed stale in visitors’ browsers because proxied images are cached for a year. Image URLs now carry the asset’s modification timestamp, so an edit in Immich becomes visible right away
- Fix: A video that could not be shared aborted the page halfway through rendering. The gallery now falls back to showing the thumbnail without a lightbox link
- Fix: The connection test reported
sharedLink.createas missing for an Immich user who can see an album but does not own it. This is now shown as a warning with an explanation instead of a false negative
0.8.1
Release Date – 4 July 2026
- Fix: Album detail pages showed “No photos found” on Immich v3+ (removed
assetsfrom the album API response); assets are now fetched via the metadata search endpoint (issue #14)
0.8.0
Release Date – 23 May 2026
- New:
link=attribute for single photos — lightbox (default), no link, or custom URL - New: Single photos always display the Immich preview image;
sizecontrols max-width (up to 1200px) - New:
align=attribute for single photos — left, right, or center for text wrapping - Fix: Image proxy output buffering issue and CSS typos (PR #11)
- Fix: Connection test false negatives on Immich v2.7+ (PR #12)
0.7.0
Release Date – 13 April 2026
- New: Apple Live Photos support — play button in the lightbox for photos with a Live Photo video component
- New: Connection & permissions check button on the settings page
- New: HTTP server URLs are now allowed (with a confirmation warning modal)
- Removed:
asset.downloadis no longer a required API permission
0.6.1
- Fix for missing album list.
For developers
Is this your plugin? Show off the numbers.
Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.
Best Gallery for Immich alternatives
All albums plugins →
FAQ
Gallery for Immich: quick answers
Straight answers, pulled from live WordPress.org data.
Live data from WordPress.org · checked Oct 16, 2026
Is Gallery for Immich free?
Yes. Gallery for Immich is free to download and use from the official WordPress.org plugin directory.
Is Gallery for Immich safe to use in 2026?
Gallery for Immich is a solid plugin choice in 2026, with a few things worth checking first. It runs on 100+ sites, is rated 5/5 and was last updated 3 weeks ago, and scores 75/100 on our health check.
How many websites use Gallery for Immich?
Gallery for Immich is active on 100+ WordPress websites and has been downloaded 2,101 times since it launched in December 2025. It was downloaded 406 times in the last 30 days.
Does Gallery for Immich work with WordPress 7.1?
Yes. The developer has tested Gallery for Immich up to WordPress 7.1.3, the latest release. It requires WordPress 5.8 or newer.
What PHP version does Gallery for Immich need?
Gallery for Immich requires PHP 7.4 or higher. Most hosts run PHP 8.x today, so it works on any modern WordPress hosting.
When was Gallery for Immich last updated?
The latest version, 0.9.0, was released on September 24, 2026 (3 weeks ago).
Who makes Gallery for Immich?
Gallery for Immich is developed and maintained by sietsevisser.
What are the best alternatives to Gallery for Immich?
The most popular alternatives to Gallery for Immich are Envira Gallery (100K+ installs), RPS Image Gallery (800+ installs) and Lloyd Gallery (100+ installs).
Powered by PageForge
Want thousands of pages that rank like these? Build them in an afternoon.
This directory runs on the same engine as PageForge. Turn any spreadsheet, CSV or API into thousands of fast, SEO-ready WordPress pages — with schema, internal links and AI-written copy baked in.
- CSV, Google Sheets & API data sources
- AI content, schema & internal links per page
- Works with Elementor, Gutenberg, Yoast & Rank Math
- Free on WordPress.org — no credit card
