# 🖼️ Topic Gallery

**URL:** <https://meta.discourse.org/t/topic-gallery/394953>\
**Category:** Plugin\
**Created:** [February 2, 2026, 2:27pm UTC](https://meta.discourse.org/t/topic-gallery/394953 "2026-02-02T14:27:49Z")\
**Posts on this page:** 1\
**Showing post:** 1

<div class="post-metadata">

**Author:** ![Canapin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/canapin/32/119591_2.png) [@Canapin](https://meta.discourse.org/u/Canapin)\
**Post date:** [February 2, 2026, 2:27pm UTC](https://meta.discourse.org/t/topic-gallery/394953/1 "2026-02-02T14:27:50Z")

</div>

| | | |
| --- | --- | --- |
| ℹ | **Summary** | Add a gallery view for each topic |
| 👓 | **Preview** | [Click to see a gallery example](https://canapin.discourse.diy/gallery/share-your-pictures/10) |
| 🛠 | **Repository Link** | [https://github.com/Canapin/discourse-topic-gallery](https://github.com/Canapin/discourse-topic-gallery) |
| 📖 | **Install Guide** | [How to install plugins in Discourse](https://meta.discourse.org/t/install-plugins-in-discourse/19157) |

## Description

Topic Gallery displays all images from a discussion on a dedicated page.

## Use cases

Ideal for image-focused communities and/or categories in which users post many pictures.  
It allows for a full picture experience without the regular topic interface and other contents getting in the way.

 ![Topic Gallery screenshot](https://global.discourse-cdn.com/meta/original/4X/b/f/5/bf512ff516226186f7ff2a4d22d8ebcdb9099026.jpeg)

Mobile view:

 ![Topic Gallery mobile screenshot](https://global.discourse-cdn.com/meta/original/4X/3/b/f/3bf8073d291cd3ade14372f4a229e42cebdc501c.jpeg)

You can try it [here](https://canapin.discourse.diy/gallery/share-your-pictures/10). This is primarily a test instance, so the availability is not guaranteed.

## Features

### Main features

- Infinite swiping! \[1\]

- User and date filters

- Starts gallery from a given post

- Group-specific access

- Category-based exclusions

- Link to the source post below the currently open image, so you’re never lost:  
 ![Gallery Topic source post link](https://global.discourse-cdn.com/meta/original/4X/3/0/7/3071681e7bf137f8f6cf71b6f83572a85fa7b564.png)

- Shows grouped pictures (belonging to the same post) on mouse over:  
 ![Topic Gallery grouped pictures](https://global.discourse-cdn.com/meta/original/4X/e/0/b/e0bd3f32a18783cc4820d232dfa318d1f9dd789e.gif)

### Navigation from a topic to a gallery

Several buttons are available to navigate from a Topic to a Gallery:

- Below the timeline:  

- At the end of a topic:  
 ![Topic Gallery topic button](https://global.discourse-cdn.com/meta/original/4X/f/5/0/f5044b782d0462328ac4f0b3f6d285a55d04904b.png)

- On each post (can be disabled in the settings):  
 ![Topic Gallery post button](https://global.discourse-cdn.com/meta/original/4X/a/8/e/a8e2ef37b3a78007dce6640bfef3f9f1a317018e.png)

### Gallery URLs

The gallery URL syntax is the same as a regular topic, but `/t/` is replaced with `/gallery/`:

[`https://canapin.discourse.diy/t/share-your-pictures/10`](https://canapin.discourse.diy/gallery/share-your-pictures/10)  
👇  
[`https://canapin.discourse.diy/gallery/share-your-pictures/10`](https://canapin.discourse.diy/gallery/share-your-pictures/10)

There’s also a public JSON endpoint:  
[`https://canapin.discourse.diy/gallery/share-your-pictures/10.json`](https://canapin.discourse.diy/gallery/share-your-pictures/10.json)

## Security & queries

- Feature access is restricted to allowed groups and in allowed categories.
- Galleries are restricted to users with access to their source topic.

Uploads queries exclude:

- Non-user-uploaded images
- Non-post references (custom emojis, avatars, etc.)
- Uploads from posts that the current user has no access to, meaning:
  - Whispers (if the current user can’t see whispers)
  - Hidden posts
  - Deleted posts
  - Ignored users’ posts

## Gallery Behavior

- Hotlinked images are not shown.

- Small images are not shown (minimum resolution can be changed in settings).

- Duplicate images are shown once.

- Images inside quotes are shown.

- Images in spoilers or any other block that alters their visibility, are shown.

## Settings

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `topic_gallery_enabled` | boolean | `true` | Enable the topic gallery plugin. |
| `topic_gallery_allowed_groups` | group\_list | `admins` | Groups that are allowed to access the topic gallery. |
| `topic_gallery_minimum_image_size` | integer (0–1000) | `64` | Minimum width and height (in pixels) for images to appear in the gallery. Images smaller than this in either dimension are excluded. |
| `topic_gallery_excluded_categories` | category\_list | `""` | Categories where the topic gallery is disabled. Topics in these categories will not show gallery buttons or the gallery page. |
| `topic_gallery_post_menu_button` | boolean | `true` | Show a gallery button inside each post. |

ℹ By default, the plugin is enabled for **admins** only. Visit settings to enable other groups.

* * *

1. Reaching the end of the first batch of images automatically loads and appends the next batch.

---

_[View the full topic](https://meta.discourse.org/t/topic-gallery/394953)._