Settings

You can configure plugin-wide behavior by opening Settings → Gallery View.

The settings panel is split into two tabs: General and Providers.

---

General tab

The General tab controls core plugin behavior and remote image handling.

Setting	Default	Description
Error display mode	Full	Controls how errors in a gallery block are shown. Full and Text only both show a one-line message (starting with ⚠️) where the gallery would be. Hidden shows nothing.
Show captions	On	Controls persistent caption display under images in Masonry, Thumbnail, and Carousel views, and on hover in the Justified view. When toggled off, persistent captions are hidden.
Caption max lines	1	Controls the maximum number of text lines displayed for image captions before truncating with an ellipsis (configurable between 1 and 10).
Allow remote images	Off	Enable loading images from external URLs. Disabled by default to protect your privacy. If disabled, any external sources in your blocks will be skipped.
Remote load timeout (ms)	30000	How long the plugin waits for a remote image to load before giving up. Useful for slow network connections or slow remote servers.
Validate remote content type	Off	When enabled, the plugin performs a lightweight HEAD request to verify that a remote URL actually serves an image (e.g., image/jpeg) before attempting to load it. This reduces accidental loading of non-image resources, at the cost of one extra small network request per URL.
Detached gallery grace period (ms)	30000	How long to keep a gallery alive in memory after its container is removed from the view. This is useful for preventing galleries from reloading their images constantly if you frequently toggle between reading and editing modes.
Enable pagination by default	Off	Split every gallery into pages with Prev/Next buttons instead of one long scroll. A gallery can override this with pagination in its view: block (see Gallery block syntax).
Images per page	24	Images per page when pagination is on. A gallery can override this with itemsPerPage.
Enable debug logging	Off	Write verbose debug logs (gallery rendering, refreshes, lifecycle events) to the developer console. Useful for troubleshooting. Errors and warnings are always logged.

---

Providers tab

The Providers tab manages authenticated connections to your Immich and Nextcloud servers. These connections are used by the immich and nextcloud source types to access your personal libraries and folders.

[!NOTE] Public shared links (immich-share and nextcloud-share source types) do not require any configuration here — they work directly using public share URLs.

Immich Connections

1. Click Add Immich connection.
2. Fill in the connection details:

Field	Description
Connection key	A short, memorable name you choose (e.g. home, work). This is referenced in your gallery blocks under connection:.
Base URL	The root URL of your Immich server, e.g. https://immich.example.com.
API key	A personal API key generated in your Immich account under Account settings → API Keys.

3. Click Test connection to verify credentials.

---

Nextcloud Connections

1. Click Add Nextcloud connection.
2. Fill in the connection details:

Field	Description
Connection key	A short, memorable name you choose (e.g. nextcloud-demo, my-cloud). Referenced in your gallery blocks under connection:.
Base URL	The root URL of your Nextcloud server, e.g. https://cloud.example.com.
Username	Your Nextcloud login name (shown in Nextcloud under Personal settings). An email address or display name won't work.
App Password	An App Password generated in Nextcloud (Settings → Security → Devices & sessions → Create new app password).

3. Click Test connection to verify WebDAV authentication.

Removing a connection

Click Remove connection next to the connection you want to delete. This only removes stored credentials — it does not affect your server or notes.

[!WARNING] If you remove a connection whose key is referenced in a gallery block, that block will show a "Connection not found" error until you restore the connection or update the block.