troubleshooting · how to
A command is not recognized
Diagnose and recover when a command is not recognized needs attention.
Use this guide when Slack does not autocomplete or respond after you type a Slash Social slash command.
Symptoms
You see one or more of these when you try to run a command:
- Slack shows no autocomplete suggestion for the command you typed.
- Pressing Enter does nothing or Slack says the command is unknown.
- A different app with a similar name appears in autocomplete instead of Slash Social.
- Commands that worked before stopped working after a workspace change or admin update.
- You typed a command you expected from documentation or a teammate, but only
/socialappears.
You need access to Slash Social in the affected workspace. Admin approval or reinstall may require a workspace owner or support.
Likely causes
- Slash Social is not installed in this workspace.
- You typed a command that is not one of the three public slash commands.
- The app install is stale after a workspace migration, permission change, or outdated manifest.
- You are in a guest workspace, shared channel, or wrong team where Slash Social is not installed.
- Slack suggests a different app with a similar name.
- The workspace admin has not approved or restricted the app install.
Checks
- Confirm you are in the workspace where the team installed Slash Social, not a guest or shared channel from another workspace.
- Type
/socialwith no extra text and wait for Slack autocomplete. - Try
/social-createand/social-approve, the other public commands. - Open Apps and search for Slash Social. Confirm it is installed and not pending approval.
- For tasks beyond the three public commands, type
/socialand search inside the Command Palette instead of inventing a new slash command. - Note whether App Home or modals from
/socialstill open. If nothing responds, the install may be missing or broken.
Fix it
- Use the public commands:
/social,/social-create, and/social-approve. - Open tasks from the Command Palette when you need Create, Plan, Workflow, or Settings actions that are not direct slash commands. Type
/socialand search for the workflow you need. - Reinstall the app from
https://go.slashsocial.app/slack/installif Slack no longer suggests any of the three commands. - Ask a workspace admin to approve the app if Slack shows it as restricted or pending.
- Retry in the correct workspace if you were testing from a guest account or shared channel tied to another team.
Confirm the fix
Slack autocompletes the command you typed and opens the expected modal, App Home update, or approval view. /social-create opens the create flow and /social-approve opens approval surfaces when you have access.
Run the same test from Slack desktop and mobile if the original report came from one client only, and note which client still fails.
Prevent it next time
- Start from
/social,/social-create, or/social-approveinstead of guessing command names. - Use the Command Palette inside
/socialfor Plan, Workflow, and Settings tasks. - Reinstall after major workspace migrations or when admins change app permissions.
- Bookmark the install URL for your team so admins can refresh the app quickly.
Contact support
Escalate when all three public commands fail in the same workspace after reinstall and the app appears under Apps. Send support the workspace name, exact command text you typed, Slack client (desktop or mobile), any error banner Slack shows, and whether App Home opens from the Apps menu.
Related reading: Start workflows from slash commands, Slack slash commands reference, and Install or reinstall does not complete.