swiftimg

← Blog · · 4 min read · Updated

ShareX screenshot uploads: setup, links and troubleshooting

ShareX can upload a screenshot and put its link on your clipboard. Use the swiftimg ShareX setup page for the current downloadable uploader and exact configuration steps.

Set up one successful upload

  1. Create a free account and an API key in your account.
  2. Download and import the ShareX uploader. In the custom uploader settings, add Authorization: Bearer YOUR_API_KEY as a request header.
  3. Select swiftimg as the custom image uploader. Enable the ShareX after-capture task to upload the image and the after-upload task to copy its URL.
  4. Capture a non-sensitive sample. Open the copied link, confirm the image appears, and check it in your account library.

Free uploads are public. Paid accounts can choose private uploads; commercial use requires Business. A generated uploader file containing your key is a credential: keep it out of repositories and shared screenshots.

Pick the right link

The downloaded uploader copies {json:pageUrl}, a viewer page. For Markdown image embeds, set its URL field to {json:directUrl}. The thumbnail field does not control the clipboard URL. See the README tutorial for a working embed.

When an upload fails

Edit before sharing

For a manual workflow, use the free image editor to crop or resize, export a file, then upload it. Review the image before making it public.

Swiftimg browser editor showing crop and export controls
Optional preparation in the swiftimg browser editor; this is not a ShareX settings screenshot.

On macOS or Linux, use the CLI workflow. For automated uploads, start with the API documentation.

Go ad-free with Pro

Remove ads & unlock more — from $3/mo.

See Pro

Keep reading

Host your images globally

Browser uploads and API access are available free. Paid plans add higher limits; Developer and Business include signed transforms and custom domains. Commercial use requires Business.