Media Gallery

Updated November 9, 2026

The Media Gallery block shows the files people uploaded with their entries: photos, PDFs, documents and more. Images show as thumbnails. Other files show as a document icon with a coloured type label, and PDFs show their first page.

Use it on the main board to show files from many entries, or on a Detail Board to show one entry’s files.

Upload Fields

Pick a form and one of its File Upload or Post Image fields. Click + Add upload field to show files from several fields or forms together.

Files

SettingWhat it does
Only these file typesFile extensions separated by commas, such as jpg, png, pdf. Leave empty to show every file.
OrderNewest first, Oldest first (by when the entry was submitted), or by file name A–Z or Z–A.
Most files to showA limit on how many files show in total.
Files per rowFor Desktop, Tablet and Phone: Auto, or a number. For a carousel, how many files show at once.
SettingChoices
LayoutGrid, Masonry (each file at its own height), Carousel (one row that slides) or List
More filesHow visitors see more: a Load More button or Numbered pages, with Files per page
Max width (px)Keeps the gallery narrower than its block, centred
No files messageShown when there are no files. Default: No files yet.
Show file names / type badgesLabels under or on each file
Show a search box (file names)Lets visitors search by file name

File Actions

Everyone can open a file in the built-in viewer and download it. You can also allow:

ActionWhat it does
Copy linkCopies the file’s address.
View entry (opens its Detail Board)Opens the entry the file belongs to. Pick a Detail Board for each form, and whether it opens in a new tab.
Add to Media LibraryCopies the file into the WordPress Media Library. Choose the roles that can do this; administrators always can. The entry keeps its own file, and a file already added isn’t added twice.

Upload and remove files (Detail Boards)

On a Detail Board, the Upload & Remove Files section lets people add files to the entry, or remove them, right from the board.

  1. Under Fields people can change, tick the upload fields of the Detail Board’s form that people may change.
  2. Tick Upload files and/or Remove files (with Undo).
  3. For each, choose Who: People who can edit this entry (follows the board’s Edit permission) or Users with these roles. Administrators always can.
  • Visitors get an Upload files button. They can drag files in, and pick which field to add them to when there are several.
  • The field’s own file types, size limit and number of files still apply.
  • A field that holds one file is replaced by an upload, and people are asked first.
  • Removed files can be brought back with Undo. After the Undo time runs out, removed or replaced files are deleted from the server.

Style tab

Thumbnail width, gap, corner radius and Thumbnail shape (Square or Original, no cropping). Masonry always shows each file at its own height; carousel slides use the thumbnail width.

Was this page helpful?
Scroll to top