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
| Setting | What it does |
|---|---|
| Only these file types | File extensions separated by commas, such as jpg, png, pdf. Leave empty to show every file. |
| Order | Newest first, Oldest first (by when the entry was submitted), or by file name A–Z or Z–A. |
| Most files to show | A limit on how many files show in total. |
| Files per row | For Desktop, Tablet and Phone: Auto, or a number. For a carousel, how many files show at once. |
Gallery
| Setting | Choices |
|---|---|
| Layout | Grid, Masonry (each file at its own height), Carousel (one row that slides) or List |
| More files | How 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 message | Shown when there are no files. Default: No files yet. |
| Show file names / type badges | Labels 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:
| Action | What it does |
|---|---|
| Copy link | Copies 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 Library | Copies 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.
- Under Fields people can change, tick the upload fields of the Detail Board’s form that people may change.
- Tick Upload files and/or Remove files (with Undo).
- 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.
Thanks for letting us know.
