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 type | How it appears on a page |
|---|---|
Images (image/*) | Inline thumbnail with click-to-expand |
| All other files | Download link with a typed icon |
File type icons
The [{ATTACH}] plugin recognizes these types and shows a matching icon:
| Icon type | Extensions |
|---|---|
.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 |
| Generic | everything 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
| Format | Extensions |
|---|---|
| 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
| Format | Extensions |
|---|---|
| MP4 | .mp4 |
| QuickTime | .mov |
| AVI | .avi |
| Matroska | .mkv |
| M4V | .m4v |
| WMV | .wmv |
| 3GPP | .3gp |
The extension list is configurable via ngdpbase.media.extensions.
No comments yet.