Gallery for Immich

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)
• 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:

1. Add a new block and search for “Gallery for Immich”
2. Select your display mode (all albums, single album, multiple albums, or single photo)
3. Configure display options using the sidebar controls
4. Customize thumbnail size and text sizes as needed
5. 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 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 (opens in new tab)

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)