> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mainwp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# File Uploader

> The MainWP File Uploader Extension makes it super easy to upload multiple files to all your Child Sites from one place without the hassle of logging into each site's cPanel or FTP individually.

## What You'll Learn

* Uploading files to multiple child sites simultaneously
* Setting upload paths and destinations
* Supported file types list
* Adding support for custom file types
* Deploying staged files through the Abilities API

***

> [!NOTE]
>
> **Extension Add-on** - This add-on provides standalone functionality within MainWP Dashboard. No third-party plugins required.

[File Uploader add-on - Video Tutorial](https://www.youtube.com/embed/--yNfRNTGl4)

The [MainWP File Uploader Add-on](https://mainwp.com/extension/file-uploader/) is a simple way to upload files to your child sites from one centralized location. It gives you the ability to upload multiple files to all of your child sites simultaneously.

## Upload Files to Child Sites

**1. Log in to your MainWP Dashboard**

**2. Go to the MainWP > Add-ons > Administrative > File Uploader page**

**3. Click the Choose File button and upload the wanted file (alternatively, drag\&drop files to the marked area)**

Click the **Choose File** button and upload the wanted file *(alternatively, drag\&drop files to the marked area) ![File Uploader page with Choose File button and drag-drop area](https://mintcdn.com/mainwp/m5iWPkGmGTv3i5YV/images/add-ons/file-uploader-choose-file.png?fit=max\&auto=format\&n=m5iWPkGmGTv3i5YV\&q=85\&s=6ba8ca48b7e1c838a8e197fa5d605ac5)*

**4. Set the upload path**

Set the path where you want to upload your file(s).

**NOTE:** If a directory does not exist on the child site, it will be created.

![Animation showing how to set the upload path for files](https://mintcdn.com/mainwp/m5iWPkGmGTv3i5YV/images/add-ons/file-uploader-set-path.gif?s=1c4a8e97ff931d508275cd811ecbceec)

**5. Select where you want to upload the file(s)**

[Select websites, tags, or clients](https://docs.mainwp.com/getting-started/mainwp-user-interface.md) where you want to upload file(s)

**6. Click the Upload File button**

The file that already exists with the same name in the same directory **will be overwritten.** File names are sanitized before upload, so spaces and certain special characters in file names can be replaced with dashes. Enter the destination path exactly as you want MainWP Child to create it.

## Verified Deployments to wp-content Folders

When the upload path is inside `wp-content/uploads`, `wp-content/languages`, `wp-content/plugins`, `wp-content/themes`, or `wp-content/mu-plugins`, File Uploader uses a verified deployment. The Dashboard keeps a private staged copy of each uploaded file. MainWP Child confirms the written file's size and SHA-256 digest before the upload is reported as successful.

* If a Child site runs an older MainWP Child version without verified deployment support, File Uploader falls back to the standard upload for that site.
* Uploads to other folders, such as the WordPress root, `wp-admin`, or `wp-includes`, use the standard upload.
* Staged files are limited to 50 MiB each, 100 files, and 500 MiB in total per Dashboard user.
* Uploading to `wp-content/plugins`, `wp-content/themes`, or `wp-content/mu-plugins` requires the plugin or theme editing capabilities. Setting `DISALLOW_FILE_EDIT` on the Dashboard blocks these destinations.
* In `wp-content/uploads`, File Uploader refuses server-executable and server-configuration files such as `.php` or `.htaccess`.

## Abilities API

The Abilities-enabled File Uploader release adds eight WordPress abilities. Use them to read the staging policy, list and delete your staged files, preview and start a deployment to one Child site, check its status, and roll it back within 24 hours.

See [File Uploader Abilities](https://docs.mainwp.com/api-reference/abilities-api/file-uploader.md) for requirements, permissions, request examples, and error handling.

## Supported File Types

* .php
* .css
* .xml
* .js
* .txt
* .zip
* .rar
* .ico
* .html
* .po
* .mo
* .dat
* .jpg
* .jpeg
* .png
* .bmp
* .gif
* .pdf
* .doc, .docx
* .ppt, .pptx, .pps, .ppsx
* .odt
* .xls, .xlsx
* .mp3
* .m4a
* .ogg
* .wav
* .mp4, .m4v
* .mov
* .wmv
* .avi
* .mpg
* .ogv
* .3gp
* .3g2

## Add Support for a Custom File Type in File Uploader

By default, the MainWP File Uploader Add-on doesn't support all file types. By using the `mainwp_file_uploader_allowed_file_types` filter, it is possible to add support for any file type. In this example, we will show how to add support for the JSON file type:

**1. Install and activate the MainWP Custom Dashboard Add-on**

Install and activate the [MainWP Custom Dashboard Add-on](https://mainwp.com/extension/mainwp-custom-dashboard-extension/)

**2. Go to the PHP section (MainWP > Add-ons > Administrative > Custom Dashboard > PHP)**

**3. Paste the following code snippet and Save Changes**

```php theme={null}
add_filter('mainwp_file_uploader_allowed_file_types', 'mycustom_mainwp_file_uploader_allowed_file_types');
function mycustom_mainwp_file_uploader_allowed_file_types( $types ) {
   $types[] = 'json';
   return $types;
}

```

MainWP is not responsible for the files that you upload to your sites. The File Uploader Add-on doesn't allow uploading the .**htaccess** file. This Add-on upload files directly to your server, so treat it with the same care you would when uploading a file via FTP. Not all web hosts permit all file types to be uploaded. Also, they may not allow large file uploads. If you are having issues, please check with your host first. If you are having issues with uploading files, be sure to check that you are trying to upload a supported file type and that the file size is not over the limit declared by **PHP Max Upload Filesize** and **PHP Post Max Size** on your MainWP Dashboard server.

***

## Related Resources

* [File Uploader Abilities](https://docs.mainwp.com/api-reference/abilities-api/file-uploader.md) - Deploy staged files through the Abilities API
* [Development Add-ons](https://docs.mainwp.com/add-ons/development.md) - Browse all development tools
* [Custom Dashboard Extension](https://docs.mainwp.com/add-ons/development/mainwp-custom-dashboard-extension.md) - Add custom snippets
* [System Requirements](https://docs.mainwp.com/advanced/miscellaneous/mainwp-system-requirements.md) - PHP configuration settings


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.