---
title: "KISS Flickr Gallery: Flickr albums on WordPress | Imaginary Trout"
description: "KISS Flickr Gallery shows public Flickr albums on WordPress: server-side, cached, no browser API calls, a lazy lightbox, and a cache that survives a Flickr outage."
url: https://imaginarytrout.com/plugins/kiss-flickr/
---

KISS Flickr Gallery

# Flickr albums, fast, on your own site.

KISS Flickr Gallery shows the public albums and photos of one Flickr account, rendered on your server and cached, so the gallery is quick and your API key never reaches the browser.

[Ask about KISS Flickr Gallery](https://imaginarytrout.com/contact/)See it running

Version

1.4.3

WordPress

6.5+

Tested up to

WordPress 7.1.4

PHP

8.1+

Releases

22

License

GPL 2.0 or later

## What it solves

Organizations that shoot a lot of events often keep their photos on Flickr. Embedding those albums usually means slow scripts in the browser and a gallery that goes blank when Flickr has a bad day.

This plugin asks Flickr from the server, keeps a snapshot in the database, and serves the last good copy if Flickr is down. Visitors only ever load the images.

## What it does

- ### Server-rendered albums

    The first cover is a real image, so nothing shifts while the page loads.

- ### Batches as you scroll

    Justified or masonry grids, laid out from the sizes Flickr returns, with no layout library.

- ### Lightbox on first click

    PhotoSwipe loads only when someone opens a photo: touch, keyboard, captions and a View on Flickr link.

- ### No browser API calls

    Every Flickr request is server-side, and the key never appears in the page source.

- ### Outage-proof cache

    Snapshots live in the database, so they survive cache flushes and Redis restarts, and serve during a Flickr outage.

- ### Three ways to place it

    A shortcode, a block or an Elementor widget, sharing one renderer.

- ### SEO plugin aware

    Works with Rank Math and Yoast for album titles and Open Graph on shared album links.

## What it needs

- WordPress 6.5 or later
- PHP 8.1 or later
- A Flickr API key (the free non-commercial key)
- Public photos only, by design

## See it running

Fighter Country Foundation's photostream runs on it.

- [Fighter Country photostream (opens in a new tab)](https://fightercountry.org/photostream/)

## Install

1. ### Step 1

    Upload the kiss-flickr folder to /wp-content/plugins/ and activate it.

2. ### Step 2

    Create a Flickr API key (non-commercial) at flickr.com/services/apps/create. Only the key is needed; the secret is never used.

3. ### Step 3

    Under KISS Flickr → Connection in the admin menu, enter the key and your Flickr username or profile URL, then Save and click Test Connection.

4. ### Step 4

    Place \[kiss\_flickr\] in a page or add the KISS Flickr Gallery block.

New versions install the same way: upload the new ZIP over the old one. Settings are kept.

## Changelog

22 releases so far. The newest:

1. ### 1.4.3November 15, 2026

    - **Changed** marked compatible with WordPress 7.1.4, so the update screen no longer says "Not tested".
    - **Changed** the icon on the update screen has rounded corners and, every few seconds, flips over to Imaginary Trout's power button.
    - **Changed** the banner in the plugin details leaves room for the plugin name WordPress writes over its lower left corner.
2. ### 1.4.2November 15, 2026

    - **Added** the KISS Flickr icon beside the title on the settings page, and as the admin menu icon.
    - **Added** when a newer version is available, a red "Update to vX" badge appears beside the version number and links to Dashboard, Updates.
3. ### 1.4.1September 25, 2026

    - **Added** Back link style under Album View. The "All albums" link above the album title can be the theme's button (Elementor's button style where available, an outline button elsewhere; the default), an outline button in the link colour, or the plain text link it was.
    - **Changed** the version badge on the settings page is an outlined pill.
4. ### 1.4.0September 22, 2026

    - **Added** a loading indicator for the photo grid. Large photos can take several seconds to arrive, and until now the visitor looked at an empty page.
    - **Changed** the plugin now has its own top-level admin menu, KISS Flickr, right below Comments alongside the other KISS plugins, with one entry per settings tab.
5. ### 1.3.5September 12, 2026

    - **Fixed** with a theme header that hides on scroll down and reveals on scroll up (Salient and others), opening an album or going back could land the gallery at the top of the viewport while the header was hidden, and the header then revealed over the title and back link.
6. ### 1.3.4September 12, 2026

    - **Changed** a fixed Columns count is now the most columns to show, not a hard count.
    - **Fixed** opening an album or going back to the index scrolled the gallery under fixed theme headers, hiding the title and the back link.

## KISS Flickr Gallery questions

### 

Never. All Flickr requests are server-side and cached. Visitors' browsers only load images from live.staticflickr.com.

### 

Nothing visible. Gallery data is stored as snapshots in the options table, so a flush only clears the in-memory copy, which is rebuilt from the database without a Flickr call.

### 

No. Public content only, by design. No OAuth and no API secret are needed or stored.

### 

\[kiss\_flickr album="72177720315945885" album\_header="none"\]

### 

The plugin opts its thumbnails out of Elementor's and common theme lightboxes. If a theme still hijacks clicks, set the lightbox provider to "site" to hand the images to the theme deliberately, or report the theme so the opt-out can be added.

## Other KISS plugins

- [KISS YouTube Gallery](https://imaginarytrout.com/plugins/kiss-youtube/)
- [KISS Flush](https://imaginarytrout.com/plugins/kiss-flush/)
- [All plugins](https://imaginarytrout.com/plugins/)

## Want KISS Flickr Gallery on your site?

It is not on WordPress.org yet. It runs on the sites we build and manage. Tell us about yours, or about a plugin you need built.

[Start a project](https://imaginarytrout.com/contact/)

![](/brand/logos/trout-sticker.svg)

---

Imaginary Trout, Laramie, Wyoming. Start a project: https://imaginarytrout.com/contact/ · hello@imaginarytrout.com · 480-463-4202 (leave a message)
