PHPackages                             soulteary/flarum-upload - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File &amp; Storage](/categories/file-storage)
4. /
5. soulteary/flarum-upload

ActiveFlarum-extension[File &amp; Storage](/categories/file-storage)

soulteary/flarum-upload
=======================

The file upload extension for the Flarum forum with insane intelligence.

0.7.1(7y ago)0231MITPHP

Since Nov 3Pushed 6y agoCompare

[ Source](https://github.com/soulteary/upload)[ Packagist](https://packagist.org/packages/soulteary/flarum-upload)[ RSS](/packages/soulteary-flarum-upload/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (6)Versions (50)Used By (0)

Upload by [![Flagrow logo](https://avatars0.githubusercontent.com/u/16413865?v=3&s=20)](https://avatars0.githubusercontent.com/u/16413865?v=3&s=20) [Flagrow](https://discuss.flarum.org/d/1832-flagrow-extension-developer-group)
==================================================================================================================================================================================================================================

[](#upload-by--flagrow)

[![MIT license](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://github.com/flagrow/upload/blob/master/LICENSE.md) [![Latest Stable Version](https://camo.githubusercontent.com/d49d9a99a6310c110fc41dc51809ea74aea72a6f31ee12db9a7bc37da3fea3fb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f666c6167726f772f75706c6f61642e737667)](https://packagist.org/packages/flagrow/upload) [![Total Downloads](https://camo.githubusercontent.com/28f46d56173fc8ced5b1ff24c20de17339ce7ac6039689f06c7b79db3efb73c6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f666c6167726f772f75706c6f61642e737667)](https://packagist.org/packages/flagrow/upload) [![Donate](https://camo.githubusercontent.com/d73628b17bbfd9568a0c942585827f1391f81c21bd56e3cac269c6e2e746c469/68747470733a2f2f646973636f72646170702e636f6d2f6170692f6775696c64732f3234303438393130393034313331353834302f656d6265642e706e67)](https://flagrow.io/join-discord)

An extension that handles file uploads intelligently for your forum.

Features
--------

[](#features)

- For images:
    - Auto watermarks.
    - Auto resizing.
- Mime type to upload adapter mapping.
- Whitelisting mime types.
- Uploading on different storage services (local, imgur, AWS S3 for instance).
- Drag and drop uploads.
- Uploading multiple files at once (button and drag and drop both support this).
- Easily extendable, the extension heavily relies on Events.

For a complete overview of our releases, please visit the [milestones tracker](https://github.com/flagrow/upload/milestones) on Github.

Installation
------------

[](#installation)

Use [Bazaar](https://discuss.flarum.org/d/5151) or install manually:

```
composer require "flagrow/upload:*"
```

Updating
--------

[](#updating)

```
composer update flagrow/upload
php flarum cache:clear
```

Configuration
-------------

[](#configuration)

Enable the extension, a new tab will appear on the left hand side. This separate settings page allows you to further configure the extension.

Make sure you configure the upload permission on the permissions page as well.

### Mimetype regular expression

[](#mimetype-regular-expression)

Regular expressions allow you a lot of freedom, but they are also very difficult to understand. Here are some pointers, but feel free to ask for help on the official Flarum forums.

In case you want to allow all regular file types including video, music, compressed files and images, use this:

```
(video\/(3gpp|mp4|mpeg|quicktime|webm))|(audio\/(aiff|midi|mpeg|mp4))|(image\/(gif|jpeg|png))|(application\/(x-(7z|rar)-compressed|zip|arj|x-(bzip2|gzip|lha|stuffit|tar)|pdf))

```

A mimetype consists of a primary and secondary type. The primary type can be `image`, `video` and `application` for instance. The secondary is like a more detailed specification, eg `png`, `pdf` etc. These two are divided by a `/`, in regex you have to escape this character by using: `\/`.

Changelog
---------

[](#changelog)

Please visit the [thread](https://discuss.flarum.org/d/4154).

Check [future milestones](https://github.com/flagrow/upload/milestones).

Security
--------

[](#security)

If you discover a security vulnerability within Upload, please send an email to the Flagrow team at . All security vulnerabilities will be promptly addressed.

Please include as many details as possible. You can use `php flarum info` to get the PHP, Flarum and extension versions installed.

FAQ
---

[](#faq)

- **AWS S3**: read the [AWS S3 configuration page](https://github.com/flagrow/upload/wiki/AWS-S3).

Links
-----

[](#links)

- [Flarum Discuss post](https://discuss.flarum.org/d/4154)
- [Source code on GitHub](https://github.com/flagrow/upload)
- [Changelog](https://github.com/flagrow/upload/blob/master/CHANGELOG.md)
- [Report an issue](https://github.com/flagrow/upload/issues)
- [Download via Packagist](https://packagist.org/packages/flagrow/upload)

An extension by [Flagrow](https://flagrow.io/).

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 78.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~18 days

Recently: every ~100 days

Total

43

Last Release

2702d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/233680abb603e1eadedd871c520c322cc14842854f8590a29966db0a498deb46?d=identicon)[soulteary](/maintainers/soulteary)

---

Top Contributors

[![luceos](https://avatars.githubusercontent.com/u/504687?v=4)](https://github.com/luceos "luceos (143 commits)")[![rylat](https://avatars.githubusercontent.com/u/6824779?v=4)](https://github.com/rylat "rylat (7 commits)")[![soulteary](https://avatars.githubusercontent.com/u/1500781?v=4)](https://github.com/soulteary "soulteary (3 commits)")[![ImakuTranslate](https://avatars.githubusercontent.com/u/25817039?v=4)](https://github.com/ImakuTranslate "ImakuTranslate (3 commits)")[![tony199555](https://avatars.githubusercontent.com/u/11675398?v=4)](https://github.com/tony199555 "tony199555 (2 commits)")[![clarkwinkelmann](https://avatars.githubusercontent.com/u/5264300?v=4)](https://github.com/clarkwinkelmann "clarkwinkelmann (2 commits)")[![KonstantinCodes](https://avatars.githubusercontent.com/u/844484?v=4)](https://github.com/KonstantinCodes "KonstantinCodes (2 commits)")[![Hiobi](https://avatars.githubusercontent.com/u/2171856?v=4)](https://github.com/Hiobi "Hiobi (2 commits)")[![theFlob](https://avatars.githubusercontent.com/u/9917848?v=4)](https://github.com/theFlob "theFlob (2 commits)")[![matejgleza](https://avatars.githubusercontent.com/u/4979665?v=4)](https://github.com/matejgleza "matejgleza (1 commits)")[![mtaberna](https://avatars.githubusercontent.com/u/2022256?v=4)](https://github.com/mtaberna "mtaberna (1 commits)")[![pierstitus](https://avatars.githubusercontent.com/u/4028149?v=4)](https://github.com/pierstitus "pierstitus (1 commits)")[![pReya](https://avatars.githubusercontent.com/u/4677417?v=4)](https://github.com/pReya "pReya (1 commits)")[![sijad](https://avatars.githubusercontent.com/u/7693001?v=4)](https://github.com/sijad "sijad (1 commits)")[![tdtgit](https://avatars.githubusercontent.com/u/4527866?v=4)](https://github.com/tdtgit "tdtgit (1 commits)")[![uidHUB](https://avatars.githubusercontent.com/u/12877339?v=4)](https://github.com/uidHUB "uidHUB (1 commits)")[![ar7n](https://avatars.githubusercontent.com/u/864040?v=4)](https://github.com/ar7n "ar7n (1 commits)")[![XEngine](https://avatars.githubusercontent.com/u/6682465?v=4)](https://github.com/XEngine "XEngine (1 commits)")[![Comocozy](https://avatars.githubusercontent.com/u/27432289?v=4)](https://github.com/Comocozy "Comocozy (1 commits)")[![csgka1](https://avatars.githubusercontent.com/u/16380986?v=4)](https://github.com/csgka1 "csgka1 (1 commits)")

---

Tags

fileuploadflarumflagrow

### Embed Badge

![Health badge](/badges/soulteary-flarum-upload/health.svg)

```
[![Health](https://phpackages.com/badges/soulteary-flarum-upload/health.svg)](https://phpackages.com/packages/soulteary-flarum-upload)
```

###  Alternatives

[fof/upload

The file upload extension for the Flarum forum with insane intelligence.

188171.7k15](/packages/fof-upload)[kartik-v/bootstrap-fileinput

An enhanced HTML 5 file input for Bootstrap 5.x, 4.x, and 3.x with features for file preview for many file types, multiple selection, ajax uploads, and more.

5.4k7.9M13](/packages/kartik-v-bootstrap-fileinput)[unisharp/laravel-filemanager

A file upload/editor intended for use with Laravel 5 to 10 and CKEditor / TinyMCE

2.2k3.3M74](/packages/unisharp-laravel-filemanager)[sonata-project/media-bundle

Symfony SonataMediaBundle

4625.5M71](/packages/sonata-project-media-bundle)[kartik-v/yii2-widget-fileinput

An enhanced FileInput widget for Bootstrap 3.x, 4.x &amp; 5.x with file preview, multiple selection, and more features (sub repo split from yii2-widgets)

2286.8M95](/packages/kartik-v-yii2-widget-fileinput)[czim/laravel-paperclip

Laravel Eloquent file attachment solution

80802.1k6](/packages/czim-laravel-paperclip)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
