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, stream through WordPress, or ignore videos)

• Photos and videos on password-protected and private pages are only shown to visitors who may see the page

• Caching of album lists, album contents and photo details, with a button to clear the cache

• 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”]

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)

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; random shows 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:

com/gallery” link_target=”same”]

link and `link_target` work for albums with the same values as for single photos. <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

* Warns when the connection to Immich is not encrypted (HTTP instead of HTTPS)

* 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. Cached album and photo details from Immich (names, descriptions, dates, IDs) are stored there too, as transients that expire after the configured cache time. No location or camera data is cached.

Support

For issues, feature requests, or contributions, please visit:

com/vogon1/immich-wordpress-plugin

Credits

• Lightbox powered by GLightbox (https://github.com/biati-digital/glightbox)

• Integrates with Immich (https://immich.app)