---
title: "Local upload"
description: "This example demonstrates the local file upload feature."
canonical_url: "https://www.tiny.cloud/docs/tinymce/5/local-upload/"
md_url: "https://www.tiny.cloud/docs/tinymce/5/local-upload/index.md"
version: "5"
last_updated: "2024-03-26T08:09:19Z"
tokens: 407
---
Important This page documents TinyMCE 5. For new projects, Tiny recommends using the latest, most up-to-date version. [See TinyMCE 8 documentation](../../latest/).
# Local upload

We’ve supported [local file picking](../file-picker/) and [image uploading](../upload-images/) for quite some time already. However making these features functional required some effort on the user’s side, while not being immediately obvious, at the same time. Some effort is still required, but we decided to supplement the feature with an intuitive UI.

Once `images_upload_url` is defined in the config, an **Upload** tab appears in the **Image Dialog**.

![Upload tab](../_images/demo_local-upload_01.png)
So a setup like this displays a friendly UI simplifying image upload either by picking it up or by dropping it in, directly from the desktop:

**Example**

```js
tinymce.init({
  selector: 'textarea#local-upload',
  plugins: 'image code',
  toolbar: 'undo redo | image code',

  /* without images_upload_url set, Upload tab won't show up*/
  images_upload_url: 'postAcceptor.php',

  /* we override default upload handler to simulate successful upload*/
  images_upload_handler: function (blobInfo, success, failure) {
    setTimeout(function () {
      /* no matter what you upload, we will turn it into TinyMCE logo :)*/
      success('http://moxiecode.cachefly.net/tinymce/v9/images/logo.png');
    }, 2000);
  },
  content_style: 'body { font-family:Helvetica,Arial,sans-serif; font-size:14px }'
});
```
All [image uploading options](../upload-images/#imageuploaderoptions) are supported, including `images_upload_handler` (a way to define custom file uploader) and `images_upload_credentials`.

For more details check [Upload Images](../upload-images/) tutorial from the General Configuration series.