Image Link Gallery

Data Source Modes

• SharePoint List: Gallery is driven by a list/library and can connect cross-site.
• Manual Images: Add images directly in the web part settings (supports dividers/section headers).

Image & Link Columns (List mode)

• Banner image auto-detect: Uses the item's banner image when available (best for Pages/News items). Also falls back to common image column names (Image, ImageUrl, Picture, Photo, Thumbnail).
• Custom image column: Select a specific column that contains image URLs. Banner image fields are still used as a fallback when an individual item has no value.
• Link URL Column (optional): Pick the column that holds each tile's link destination, or leave on Auto-detect URL column to try URL, LinkURL, Link, FileRef, and EncodedAbsUrl in order.

Filtering, Search, Sort & Paging

• Admin pre-selected values: in the property pane, choose which Category or Tag values are allowed. Items outside those values are filtered out before the page loads.
• Runtime filter dropdowns: when a Category or Tag filter is enabled and its source column has values, end users see a dropdown above the grid to narrow results.
• Search: optional debounced search box (300 ms) that matches title, description, category, and both overlay metadata fields.
• Sort (edit mode only): the Sort dropdown — A-Z, Z-A, or Custom Order — only appears on the web part toolbar while editing the page. Page editors use it to set the default display order for everyone.
• Pagination: optional Previous / Next paging. Items per page is configurable (3-50, default 12).

Custom Order (Edit Mode)

While editing the page, choosing Custom Order from the Sort dropdown opens an inline reorder panel. Drag items, use the up / down arrow buttons, or pick a position from the per-item dropdown, then click Save Order to persist it. Reset to Default reverts to the list's natural order (typically by the auto-detected SortOrder / Order / ItemOrder column).

• SharePoint List mode: saves an ordered list of item IDs on the web part instance. The underlying list is not modified.
• Manual Images mode: rewrites the manual items collection so the new order becomes the saved order.
• Saving also flips the default sort to Custom Order so end users immediately see the new order.

Favorites (Per User)

When enabled, users can star items and see them in a favorites sidebar. Favorites persist per user in the browser (local storage) and are saved per web part instance.

Manual Images Mode

Manual mode is useful when you do not want to maintain a list. Open Manage Images in the property pane to build the collection. Each manual item supports:

• Type: Image or Divider / Section Header (dividers span the full row and show the title as a section label, or an hr line if the title is blank).
• Title: required. Shown as the overlay title for images, or as the section label for dividers.
• Link URL: destination for image items (dividers ignore it).
• Description: optional overlay text.
• Image: SPFx file picker (site files, OneDrive, stock images, web search, upload, link) — accepts .gif, .jpg, .jpeg, .png, .webp, and .svg.
• Open in new tab: per-item toggle that overrides the global "Open Links in New Window" setting.

Recommended List Schema (List mode)

Image Link Gallery can auto-detect common field names, but these columns provide the best experience:

Reference

Key Settings

The property pane is organised into two accordion pages. Page 1 focuses on the data source; Page 2 on layout, appearance, and interactive features.