Image Upload Mod: How to Add Image Uploading to a Forum
To add image uploading to a forum, you have three workable paths: install a phpBB extension that handles attachments or uploads, install a third-party upload mod built for your forum version, or skip server-side uploads entirely and let members paste links from an external image host. The right choice depends on how much control you want over storage, how much server maintenance you can absorb, and whether your members need images to survive long after a post is written. The steps below cover all three, with the extension route as the primary walkthrough because it is the most common request for phpBB boards.
The three approaches at a glance
| Approach | What it does | Best when | Main trade-off |
|---|---|---|---|
| phpBB attachment/upload extension | Stores files on your own server and serves them from your domain | You want images tied to the forum and under your control | You own the disk space, backups, and bandwidth |
| Third-party upload mod | Adds upload UI or gallery features beyond core attachments | You need a specific feature the core does not offer | Compatibility depends on the mod author keeping pace with phpBB releases |
| External image host | Members upload elsewhere and paste an image link into the post | You want zero storage cost and minimal server work | Images can disappear if the host removes them or the account lapses |
If your goal is simply "members can put pictures in posts," the core attachment system plus a well-configured extension is usually enough. Reach for a dedicated mod only when you need something the core does not do.
Installing and enabling an upload extension in phpBB
phpBB extensions live in the ext/ directory and are switched on from the Administration Control Panel (ACP). The general sequence is the same for most extensions.
1. Confirm your phpBB version
Check the version in the ACP or in the forum footer. Extensions written for phpBB 3.1 and later use the ext/ structure; older "MODs" used file edits and are not compatible with modern boards. Installing a legacy MOD on a current phpBB release is one of the most common causes of a broken board.
2. Download and unpack the extension
Get the extension from its official release page or the phpBB extensions database. Unpack it locally. The archive usually contains a folder structure like vendor/extensionname/. That full path is what belongs under ext/.
3. Upload to the ext directory
Using FTP or your host's file manager, upload the unpacked folder so the final path looks like:
your_forum_root/ext/vendor/extensionname/
A frequent mistake is uploading one level too deep or too shallow, producing ext/extensionname/vendor/ or ext/vendor/. phpBB will not detect the extension if the path is wrong.
4. Enable it in the ACP
Log in to the ACP, go to Customise → Manage extensions, and find the extension under "Disabled extensions." Click Enable. If it does not appear at all, the path is wrong or the extension is incompatible with your version.
5. Configure permissions and settings
After enabling, set who can upload. Under Permissions, grant the relevant attachment or upload permission to the groups that should have it (for example, registered users but not guests). Then open the extension's settings page to set allowed file types and size limits.
Setting limits so uploads are not rejected
Most "upload failed" reports trace back to a limit somewhere in the chain. There are three layers, and the strictest one wins.
- Forum attachment settings — In the ACP under Attachment settings, set the maximum file size and the allowed extensions (for example,
jpg,png,gif). If a format is not listed, it is rejected regardless of size. - PHP limits —
upload_max_filesizeandpost_max_sizein your PHP configuration cap what the server will accept. If your forum allows 10 MB but PHP allows 2 MB, uploads over 2 MB fail. - Directory permissions — The upload directory (commonly
files/) must be writable by the web server. If permissions are wrong, the file never lands even when size and type are fine.
Set the forum limit at or below the PHP limit, and keep the upload directory writable but not world-executable.
Troubleshooting common failures
"The extension does not appear in Manage extensions." The folder path under ext/ is wrong, or the extension targets a different phpBB version. Re-check the path and the version requirement.
Uploads under the limit still fail. Compare the forum's max size against upload_max_filesize and post_max_size. The lowest value is your real ceiling.
"Tried to upload empty file" or permission errors. The upload directory is not writable. Fix ownership and permissions so the web server user can write there.
Images upload but do not display. The stored path or base URL is misconfigured, or a security setting is blocking direct access to the files directory.
Board breaks after installing a mod. You likely installed a legacy file-edit MOD on a modern phpBB. Restore from backup and use an extension instead.
Using an external image host as the alternative
If you would rather not store images on your server, members can upload to an image host and paste the direct image link into a post, wrapped in [img] tags:
[img]https://example-host.com/your-image.jpg[/img]
This removes storage and bandwidth from your plate, but it introduces a dependency: if the host deletes the image or the account expires, the post shows a broken image. For a forum where old threads matter, that risk is worth weighing against the convenience. Services built specifically for forum use, such as Image Chest, position themselves around forum image hosting, which is the scenario where link-based embedding is most common.
Choosing between the options
- Pick a phpBB extension if you want images stored on your own server, tied to the forum, and under your backup routine.
- Pick a third-party upload mod only if it offers a feature the core attachments lack and it explicitly supports your phpBB version.
- Pick an external image host if you want to avoid server storage and maintenance and can accept that images live outside your control.
Whichever you choose, verify the result the same way: upload a test image at the size limit, confirm it displays in a post, and check that a guest sees it as intended. That single test catches most path, permission, and limit problems before your members do.