Supported File Types

Last modified: 4/7/2026

Supported File Types

What you can upload depends on where you are uploading — page attachments, the media library, and image fields each have different rules.

Page Attachments

Uploaded via the page editor or [{ATTACH}] plugin. Any file up to 10 MB is accepted.

How attachments render

File typeHow it appears on a page
Images (image/*)Inline thumbnail with click-to-expand
All other filesDownload link with a typed icon

File type icons

The [{ATTACH}] plugin recognizes these types and shows a matching icon:

Icon typeExtensions
PDF.pdf
Word.doc .docx
Excel.xls .xlsx
PowerPoint.ppt .pptx
Archive.zip .tar .gz .7z
Audio.mp3 .wav .ogg .m4a
Video.mp4 .mov .avi .webm
Text.txt .csv .md
Genericeverything else

Note: Audio and video attachments appear as download links, not players. To embed a player, use the [{VideoPlayer}] or [{AudioPlayer}] plugin.

Configuring allowed types

The config key ngdpbase.attachment.allowedtypes (default image/*,text/*,application/pdf) documents the intended policy. See ConfigAccessorPlugin to display the current value.


Image Uploads

Used for profile photos and other image-only fields. Strictly enforced:

Allowed extensions
.jpg .jpeg .png .gif .webp .svg

Maximum size: 10 MB


Media Library

The media library (/media) accepts photos and video files:

Images

FormatExtensions
JPEG.jpg .jpeg
PNG.png
GIF.gif
WebP.webp
BMP.bmp
HEIC / HEIF.heic .heif
TIFF.tiff .tif
RAW (various cameras).raw .orf .cr2 .nef .arw .dng

Video

FormatExtensions
MP4.mp4
QuickTime.mov
AVI.avi
Matroska.mkv
M4V.m4v
WMV.wmv
3GPP.3gp

The extension list is configurable via ngdpbase.media.extensions.