Troubleshooting
Messages are quoted as Snag shows or says them. Where a message names a destination or agent, the name is in angle brackets.
Recording and speech
| Message | Cause | Fix |
|---|---|---|
| "Microphone access is off. Allow it in Settings." | Microphone permission denied | Open Settings, the Snag entry, turn Microphone on |
| "Couldn't start the microphone." | Another app or a phone call holds the audio | End the call or the other app's recording, then try again |
| "Couldn't start recording. Open Snag and tap the button." | A capture from Siri or a control could not start, usually with the phone locked | Enter the passcode, open Snag, tap the mic |
| "I can't hear you." | Nothing above speech level for 8 seconds | Speak closer to the microphone, or check the audio route (AirPods, car) |
| "Nothing snagged, I can't hear you." | The first hands-free turn had no speech. The recording is kept on the phone, unsent | Recent shows "Nothing heard. Kept on this phone"; Retry sends it |
| "Nothing heard. Add more, or done?" | A later turn had no speech; that turn is dropped | Say "add more" to try again, or "done" |
| "Nothing saved." | Every turn was scrapped before "done" | None needed |
| "Couldn't save that recording." / "Couldn't save this on the phone. Try again." | The phone could not write the capture, usually because storage is full | Free some space. The card keeps the text for another try |
| No live transcript for a language | The phone has no on-device model for it and the speech-server question was answered "Keep it on this iPhone" | Speak a language the phone supports on device. See Privacy |
Sending
| Message | Cause | Fix |
|---|---|---|
| "Saved on the phone. I'll send it when there's signal." / Recent "Waiting for signal" | No network, or the destination was slow | None: Snag retries on launch, when it comes to the front and when the network returns |
| "Saved. Sign in needed, I'll keep it." / "Snagged. Sign in to <name> again to send it." / Recent "Sign in to <name> again" | The destination refused the sign-in (expired or revoked token, removed permission) | Settings > the connection > Sign in again. Queued captures then send |
| "Saved, but it was refused. It's in the list." / Recent "Couldn't send. Kept on this phone" | The destination refused the capture for good (for example a webhook that returns 404) | Fix the destination, then Retry in Recent. The capture is still in your Snag account |
| "Snagged. <name> gets it when Snag is open." | Apple Notes, Things and Email-in send only while Snag is on screen | Open Snag |
| Notification "Captures are waiting: connect <name> again in Snag." | As "Sign in needed" above, while Snag was in the background | As above |
Each destination has its own retries, so one that is down does not hold up the others. Retries do not make duplicates. Per-destination messages are on each destination's page under Destinations.
Connections
| Message | Cause | Fix |
|---|---|---|
| "Couldn't keep that token on this iPhone." | The Keychain refused the save | Restart the phone and paste the token again |
| "Couldn't load the list." | The token or sign-in is wrong, or the service is unreachable | Check the token, then Try again |
| "One-tap sign-in to <service> isn't available in this version..." | That service cannot be connected in this version | Use Email-in or Send to a URL where the service accepts them |
| "Send to more than one place" | Free sends each capture to your Snag account and one connection | "Switch to <name> instead", or Pro. See Free and Pro |
| "Couldn't keep access to that folder. Pick it again." | Obsidian vault folder access was lost | Settings > Obsidian > choose the vault folder again |
| "Reminders access is off. Turn it on in the Settings app under Snag." | Reminders permission denied or limited | Open Settings, the Snag entry, Reminders: Full Access |
| "Nextcloud didn't accept that login name and app password." | Wrong login name or app password | Make a new app password in Nextcloud and paste it |
Siri, widgets and the Live Activity
| Symptom | Cause | Fix |
|---|---|---|
| "Give the task a name." | "Add a task in Snag" with nothing said | Say the task |
| "Choose where tasks go in Snag's settings first." | No connection takes tasks | Connect one, or make one the default |
| "Nothing to note." / "Nothing to ask." | Siri heard nothing after the phrase | Try again |
| Widgets say "Open Snag to see your latest captures." or "Open Snag to see what's waiting" | Snag has not been opened since it was installed or updated | Open Snag once |
| No Live Activity while recording | Live Activities are off for Snag | Settings > Snag > Live Activities on |
| The headphones offer does not appear | It shows once a session; "Not now" quiets it for the day; it can be turned off | Settings > Switching > Offer hands-free with headphones |
Snag Control
| Message | Cause | Fix |
|---|---|---|
| "Snag Control is a Pro feature." | The Free plan | See Free and Pro |
| "Couldn't reach <agent>. Parked." / "Couldn't reach that agent." | The agent's backend did not answer | Check the agent is running; Send again from Parked |
| "<agent> needs signing in. Parked." | The backend refused the key | Agent page > fix the key, then Send again |
| "<agent> can't take that." | The agent neither answers questions nor takes jobs | Ask another agent |
| "No agent to ask yet. Connect one in Snag." | Siri "Ask Snag" with no agents | Add an agent in the Control tab |
| "Nothing answered yet. Check the address and the key; Snag tries again each time it opens." | A new agent's address did not answer | Check the address and key |
| "That one waits until you've stopped." | An irreversible action asked by voice while driving | Approve it on the phone when stopped |
| "That one needs the phone. Parked." | The approval needs a confirmation the voice path cannot give | Approve it on the phone |
| "That one has expired. Held." | The agent's approval window passed | Ask the agent again |
| "That's not it. Parked." | Wrong code word, or silence (one try) | Approve on the phone when stopped |
| "Parked until you've stopped." | No code word is set, or the agent does not allow the action in the car | Set a code word in Settings > Approvals, or approve on the phone |
| "Needs Face ID. Nothing was approved." / "Not approved. Face ID or the passcode didn't go through." | Face ID failed or was cancelled | Try again |
| "Set a passcode on this iPhone to approve this. Nothing was approved." | Irreversible approvals need a device passcode | Set a passcode in iOS Settings |
Voice commands
| Message | Cause | Fix |
|---|---|---|
| "That workflow refused the key." | The workflow returned 401 or 403 | Check the signing secret on both sides |
| "That workflow failed." | The workflow returned an error | Check the workflow's own run log |
| "Couldn't reach that workflow." | No network, or the address is wrong | Check the address |
| "Only https, or http on a local network." / "Plain http is only for a local network address. Use https." | The address is plain http to a public host | Use https |
| "Last check failed, the accepted version keeps working: ..." | A commands repo could not be read on the last check | Follow the reason shown (sign in again, address not found, file has a mistake) |
| "No .snag/commands.yaml on this branch." | The repo or branch has no commands file | See Commands repo format |
Snag Pro
| Message | Cause | Fix |
|---|---|---|
| "The purchase didn't go through. Nothing was charged." | Cancelled or declined | Try again |
| "Apple couldn't confirm the purchase. Try Restore purchases." | The purchase could not be verified | Settings > Subscription > Restore purchases |
| "Pro isn't available right now. Check your connection and try again." | The App Store products did not load | Check the connection |
| "No Pro purchase found on this Apple account." | Restore found nothing on this Apple Account | Sign in to the Apple Account that bought Pro |
Still stuck
Email hello@snag.fm with what you were doing, the iPhone model and the iOS version.
Next: FAQs