How to Fix Failing Actions in iOS 12 Shortcuts

Troubleshooting a broken shortcut in iOS 12 requires isolating the specific action causing the error, verifying that data formats match between steps, and confirming system permissions. This guide provides a straightforward method to diagnose where a custom shortcut halts, inspect variable outputs, and resolve common workflow issues within the iOS 12 Shortcuts app.

1. Isolate the Failing Action

Open the Shortcuts app and tap the three dots on the shortcut to enter the editor. Instead of running the shortcut from the widget or share sheet, tap the Play button at the top of the editor. The app will visually highlight actions as they execute. Watch the flow closely; the action where the execution abruptly stops or displays a red error notification is your point of failure.

2. Inspect Data with Quick Look

Actions often fail because they receive invalid or unexpected data from the previous step. You can inspect the data being passed by temporarily inserting the Quick Look action.

  1. Tap the search bar at the bottom of the editor.
  2. Search for Quick Look and add it immediately after the action you suspect is passing faulty data.
  3. Run the shortcut.
  4. Quick Look will display a preview of the output (such as text, images, or dictionaries). If the output is empty or in the wrong format, the issue lies in the upstream actions generating that data. Remove the Quick Look action once you have verified the data.

3. Check Input and Output Data Types

iOS 12 uses a content graph to automatically convert data between actions, but conversions can fail if the source data is incompatible with the destination action.

  • Ensure an action expecting a URL is not receiving raw text without proper scheme formatting (e.g., missing https://).
  • If an action requires plain text, add a Get Text from Input action before it to force conversion.
  • When working with lists or dictionaries, ensure you use the Get Dictionary Value or Get Item from List actions before passing values into standard input fields.

If you reordered, deleted, or replaced actions, the Magic Variables connected to downstream actions may have detached or defaulted to the wrong source.

  1. Tap on the variable token inside the failing action.
  2. If the token is cleared or missing, tap the parameter field and select Select Magic Variable.
  3. Scroll up and tap the output of the exact action you want to feed into this step.

5. Check iOS System Permissions

Actions interacting with system services or third-party apps will fail silently or throw an error if permissions are disabled.

  • Go to the main iOS Settings app.
  • Scroll down to Shortcuts and verify permissions for Camera, Cellular Data, and Location Services.
  • Check the individual app settings (e.g., Photos, Reminders, Health) to ensure the Shortcuts app has read and write access.

6. Delete and Re-add the Action

Occasionally, an action's internal configuration parameters become corrupted after an iOS update or shortcut import. If an action fails despite having valid inputs:

  1. Tap the X button on the top-right corner of the failing action block to delete it.
  2. Search for the action in the bottom drawer.
  3. Drag it back into the workflow and re-enter your parameters manually.