Skip to content
Slack

Slack

Previews for uploads.sh links, answers in threads, and held-upload alerts you can approve from Slack.

What it does #

The uploads.sh Slack app turns uploads.sh links into previews. With it in your workspace:

  • A file link shows its image, the pull request or issue it belongs to, and its type, size, and upload time.
  • A live link shows the pull request title and state, the latest screenshot, and how many files it holds.
  • A gallery link shows its title, description, and cover image.

Connect your account, and the app also messages you when an upload is held for review. You can approve it from the message.

Once search is on, you can also mention the app with a question and it answers in the thread with the files it finds.

Add it to Slack #

Anyone who can install apps in a Slack workspace can add it:

Add to Slack

Slack asks for these permissions:

Permission What the app does with it
links:read Sees uploads.sh links in messages. It reads only the link, not the message.
links:write Adds the preview to an uploads.sh link.
users:read Reads your Slack name for the connect page, and checks who may search.
chat:write Sends held-upload messages and answers in threads.
im:write Opens the direct message between you and the app.
commands Adds /uploads search.
app_mentions:read Sees messages that mention the app.
channels:history Reads the thread the app was mentioned in, in public channels.
groups:history Reads the thread the app was mentioned in, in private channels.
reactions:write Adds 👀 to your message while it works on an answer.

The app reads a thread only when someone mentions it there, and never reads your Slack files. Post an uploads.sh link to see a preview.

You can also find Add to Slack under Settings → Slack in each workspace on uploads.sh.

When the app gains a feature that needs a new permission, Slack doesn’t grant it on its own. The app’s Home tab, and your Slack workspace under Slack in account settings, show Update permissions. Press it and approve the new permission on Slack’s page. Until then, the feature that needs it is off in that workspace; everything else keeps working.

Connect your account #

Open the app’s Home tab in Slack and press Connect uploads.sh. Sign in to uploads.sh if asked. The page names the Slack account it’s about to connect; confirm only if it’s yours. The link ties your Slack account in that workspace to your uploads.sh account.

Previews work without connecting. The link is for features that act on your behalf. To undo it, press Disconnect on the same Home tab, or under Slack in account settings.

Connecting doesn’t add you to a workspace and doesn’t use a seat. It only records which uploads.sh account is yours. On the free plan, the member limit still applies when someone joins a workspace, and connecting Slack doesn’t change it.

Held-upload messages #

When an upload is held for review because it may show a secret or personal information, the app sends a direct message. It names the file and the workspace, says what was found (an API key or a card number, for example), and links Settings → AI labels, where a workspace admin can turn holds off. It has two buttons:

  • Approve puts the file back at its public link, the same as uploads approve. It acts as your connected uploads.sh account, so you must be a member of the workspace.
  • Keep held leaves the file held. You can still approve it later from the file’s page or the CLI.

If the file is approved somewhere else, or deleted while it’s held, the message updates to say so and its buttons go away.

Who gets the message:

  • The person who uploaded the file, when uploads.sh knows who that is.
  • Otherwise, the workspace’s admins and owners.

Each person must have connected Slack. To stop these messages, turn off Message me in Slack when an upload is held for review under Slack in account settings. Messages arrive in the app’s Messages tab in Slack.

Ask in a thread #

Mention the app with a question, in a channel it’s in:

@uploads.sh do we have any recent screenshots from settings?

It answers in the thread with a sentence or two and the files that fit. It searches by name and by what the AI labels say a file shows (the kind of file, the screen, and the device), and looks at the images before it answers. Mention it again in the same thread to narrow the answer, for example @uploads.sh just the mobile ones. It reads the thread first, so the follow-up builds on its last answer. Replies that don’t mention it get no answer. Answers are limited each day (UTC) on the free plan, with more on Pro; a Slack workspace connected to several uploads.sh workspaces gets the highest plan among them. Past the limit the app says so until the next day.

It follows the same rules as search: a workspace admin turns it on, only full members get an answer, and it finds only public files in the uploads.sh workspaces connected to that Slack workspace, never any other workspace.

What a preview shows #

A preview shows only what the public share page shows. The app reads the same public endpoints the share pages use, so private, held, and deleted files get no preview.

Previews are visible to everyone in the channel. Post a link to a private file only where you’d share the file itself.

Discord and other chat apps preview uploads.sh links without an app. They read the share page’s own tags, which follow the same rule. See Share pages support embeds.