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)
- 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.
Customize sizes:
[gallery_for_immich size=”300″ title_size=”18″ description_size=”15″ date_size=”12″]
Size options:
* size – Thumbnail size in pixels (100-500, 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)
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.
Privacy & Security
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)
