Product support

Get help in the plugin support forum.


Collection of File Upload components for October. This is a port of the back-end fileupload form widget and modified version of Responsiv uploader. There are two primary components provided by this plugin: image uploader and file uploader. The image upload is suitable for uploading photos with thumbnails, whereas the file uploader is suitable for any type of file.

Each component will detect if the relationship is a multiple ("many") or singular ("one") type and render a different control accordingly.

Like this plugin?

If you like this plugin, give this plugin a God review, Like or Make donation with PayPal.

Attaching the uploader (from page)

To attach the uploader directly to the page as a component, you simply initialize the component either on the page or layout:

maxSize = "2"
fileTypes = "*"

Attaching the uploader (from component)

The most effective way to use this plugin is to attach the uploader from another component. Override the init method to initialize the uploader inside your component class with the addComponent method.

class MyComponent extends ComponentBase
    public function init()
        $component = $this->addComponent(
            ['deferredBinding' => false]

        $component->bindModel('files', Project::find(1));

The component can then be rendered on the page as normal:

    <!-- File uploader -->
    {% component 'fileUploader' %}

As a side note, if you wish to refresh the component via an AJAX handler, ensure that you call the pageCycle method to initialize the page components.

public function onRefreshFiles()

Uploader with deferred binding

You may wish to upload a file and attach it to a model that doesn't exist yet. This is possible using deferred bindings, a feature built-in to October.

The first step is to tell the uploader that we are using deferred bindings by setting the component property deferredBinding to 1.

deferredBinding = "1"

Make it working as user Avatar

See this topic: https://octobercms.com/plugin/support/netsti-uploader/tips-to-make-it-working-as-user-avatar

  • Found the plugin not useful on 29 Mar, 2019

    Make yourself a favor and run away from this plugin.

    • It is a fork from this project = https://github.com/responsiv/uploader-plugin
    • The author has failed to answer if extra features were added to this project
    • The public repository is broken, there hasn't been updated in almost 2 years

  • Found the plugin useful on 22 Jan, 2019

    I couldnt see any file size limitation control for uploaded image?

  • Found the plugin not useful on 13 Dec, 2018

    For those who still stuck in avatar image on update page, here is a robust solution without any plugin:

    ``//inside update.htm or whatever...

    <form data-request="onUpdate" data-request-files data-request-flash>

    <input type="hidden" name="_handler" value="onUpdate">
    {{ form_token() }}
    {{ form_sessionKey() }}
    <input type="file" accept="image/*" name="avatar" id="imageUpload">
    <img class="rounded" id="imageUploadPreview" width="100px">
    <img class="rounded" src="{{ user.avatar.thumb(100,100,{mode:'crop'})}}">
    //some other stuff name, email...


    And for image preview, add this code to assets/js/app.js or similar...

    ``jQuery(document).ready(function($) {


     function readImageURL(input) {
        if (input.files && input.files[0]) {
            var reader = new FileReader();
            reader.onload = function(e) {
    $("#imageUpload").change(function() {


    I struggled a lot trying plugins, this did a great job for me, hope helps others :)

  • Found the plugin not useful on 17 Oct, 2018

    The <script type="text/template"> section seems to bug out and not display properly. The fist slash "/" in meets, makes the remaining template jump outside the script tag and mess up the entire HTML.

  • Found the plugin useful on 12 Jan, 2018

    Excellent!! Plugin!! :) .... Congratulation really is the best!... But... I have a little problem. Show this error when press remove a file or a image. "AJAX handler 'imageUploader::onRemoveAttachment' was not found.".

    I don't know is too can help me, if i want show the list, but using a {% for %} ... how is that? I want a apply a style. Thanks for all!

    Again, Excellent!! Plugin!! :) ..hahahha.. Congratulation really is the best!...

  • Found the plugin useful on 25 Apr, 2017

    Great plugin for us!

  • Found the plugin useful on 13 Apr, 2017


  • Found the plugin useful on 11 Apr, 2017

    works without problems to upload images. i use it too for the profile image upload.

  • Found the plugin useful on 9 Jan, 2017

    Excellent plugin. Simple to use and just works! Using it on two projects.

  • Found the plugin useful on 2 Sep, 2016

    I used it to allow my users to upload a profile image. Work like a charm

  • author

    Replied on 2 Sep, 2016

    Thanks! Enjoy it!


Remove RainLab.Builder dependency and work with attachOne relationship

Dec 31, 2016


Initialize plugin.

Apr 05, 2016