Custom Uploaders - ShareX Feature for Windows

Custom Uploaders

ShareX's custom uploader system is one of its most powerful features, allowing you to upload files to virtually any service or server. With support for dozens of built-in destinations and the ability to create your own, ShareX gives you complete control over where your files go.

Built-in Destinations

ShareX ships with support for many popular services out of the box:

Category	Supported Services
Image Hosts	Imgur, ImageShack, Flickr, Photobucket, Google Photos
File Hosts	Dropbox, Google Drive, OneDrive, Amazon S3, Mega
Text Hosts	Pastebin, GitHub Gist, Paste.ee, Hastebin
URL Shorteners	Bitly, TinyURL, is.gd, Google URL Shortener
Social Media	Twitter, Reddit, Pinterest, Tumblr
Video	YouTube, Streamable, Vimeo

Custom Uploader Configuration

If your preferred service isn't listed, you can create a custom uploader:

1. Go to Destinations → Custom uploader settings
2. Define the Request URL (the API endpoint)
3. Set the Request method (POST, PUT, etc.)
4. Configure Headers (authorization tokens, content types)
5. Define Body parameters (file, metadata, etc.)
6. Set up Response parsing to extract the resulting URL
7. Test your configuration with the Test button

URL Parsing

ShareX can parse the upload response to extract the file URL:

• JSON/XML parsing — Use JSONPath or XPath to extract URLs from structured responses
• Regex parsing — Use regular expressions for custom or non-standard response formats
• Header parsing — Extract URLs from response headers (e.g., Location header)
• Support for multiple URL types (direct file URL, deletion URL, thumbnail URL)

Advanced Features

Custom uploaders support:

• File compression — Compress files before uploading (ZIP, image optimization)
• Custom arguments — Pass additional parameters in the request
• OAuth authentication — For services requiring OAuth flow
• Error handling — Define custom error detection patterns
• Import/Export — Share uploader configurations as JSON files

Custom Return Parsing

After uploading, ShareX can detect and copy:

• The direct file URL
• A deletion URL (for services that support deletion)
• A thumbnail URL
• Any custom response field
• Combined result (URL + additional text)

Importing and Sharing Configurations

• Export your custom uploader as a .sxcu file to share with others
• Import uploader configurations from the community
• Browse the official ShareX custom uploader repository for community-created configurations
• Create separate uploader profiles for different use cases

Enterprise Integration

Custom uploaders make ShareX suitable for enterprise environments:

• Upload directly to internal servers via FTP, SFTP, or HTTP APIs
• Integrate with self-hosted file sharing solutions (Nextcloud, ownCloud)
• Connect to custom CDN endpoints
• Implement corporate authentication and security policies