Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
demo Fix path to plugin in demo May 23, 2018
src Add editing uploaded images and files Feb 15, 2019
.editorconfig add editorconfig May 12, 2018
.eslintignore add rollup, release-it, demo, linting May 2, 2018
.eslintrc.json add rollup, release-it, demo, linting May 2, 2018
.release-it.json Updare release config May 16, 2018
AUTHORS.txt Fix text and list of folks in authors May 16, 2018 Fix changelog Feb 21, 2019
LICENSE Create LICENSE Jun 28, 2016
rollup.config.js Update dependencies Feb 21, 2019

File Uploader by Uploadcare

This is a plugin for TinyMCE, a WYSIWYG HTML editor, providing it for working with Uploadcare Widget.

The plugin allows TinyMCE users to upload media from their devices, social media, cloud storage, and more. All that without any backend code that's usually required to handle uploads.

GitHub release  Uploadcare stack on StackShare


Check out the basic demo here.


TinyMCE 4+.


Download the latest plugin archive from the release branch or releases page.

Extract the downloaded archive to the plugin directory of your TinyMCE installation.

Another option here is cloning the repo:

git clone -b release plugins/uploadcare


Add uploadcare to the list of your TinyMCE plugins and the toolbar. Set your public key. Public keys are used to identify a target Uploadcare project your uploads will go to.

  selector: '#editor',
  plugins: 'uploadcare',
  toolbar: 'uploadcare',
  external_plugins: {
    uploadcare: '/path/to/uploadcare/plugin.js',
  uploadcare_public_key: 'YOUR_PUBLIC_KEY',


Plugin configuration

To apply a custom configuration, initialize the TinyMCE editor providing additional options:

  selector: '#editor',
  plugins: 'uploadcare',
  toolbar: 'uploadcare',
  external_plugins: {
    uploadcare: '/path/to/uploadcare/plugin.js',
  uploadcare_public_key: 'YOUR_PUBLIC_KEY',
  /* when handling images, you can resize them on a client to save bandwidth */
  uploadcare_image_shrink: '500x375',
  /* allow multi-file uploads */
  uploadcare_multiple: true,
  uploadcare_multiple_max: 3,
  /* set crop options when handling images */
  uploadcare_crop: '1:1,4:3',
  /* feel free to add more options here */

You can use any widget options providing those as object keys. Just add the uploadcare_ prefix and use snake_case instead of camelCase in option names, e.g. imagesOnlyuploadcare_images_only.

Widget configuration

Uploadcare Widget can be deeply customized to suit your UX/UI. You can define allowed upload sources, implement file validation, and more.

Use our live widget sandbox as a starting point and consider checking out the docs on widget configuration and its JavaScript API.

Security issues

If you think you ran into something in Uploadcare libraries which might have security implications, please hit us up at or Hackerone.

We'll contact you personally in a short time to fix an issue through co-op and prior to any public disclosure.


Issues and PRs are welcome. You can provide your feedback or drop us a support request at

You can’t perform that action at this time.