errordomain=nscocoaerrordomain&errormessage=could not find the specified shortcut.&errorcode=4

If you have landed on this page, you are almost certainly looking at the exact error string errordomain=nscocoaerrordomain&errormessage=could not find the specified shortcut.&errorcode=4 on an iPhone, iPad, Mac, Apple Watch, in HomeKit, or inside Xcode while developing a Swift app. The same error shows up in Italian as errordomain=nscocoaerrordomain&errormessage=non è stato possibile trovare il comando rapido specificato.&errorcode=4 and in Portuguese as errordomain=nscocoaerrordomain&errormessage=não foi possível encontrar o atalho especificado.&errorcode=4. All three are the same underlying problem with the same root cause and the same fix. In this guide, we walk through everything you need to know — what the error actually means in plain English, every situation that triggers it, step-by-step fixes for everyday iOS and macOS users, fixes for HomeKit and Apple Watch users, the Swift code patterns that cause it and the correct patterns that prevent it, terminal commands for advanced debugging, and the same fixes in five other languages so this single page works as your reference no matter what locale your device is in.

What does the NSCocoaErrorDomain "could not find the specified shortcut" error mean?

The error string breaks into three parts. errordomain=nscocoaerrordomain tells you which family of errors this belongs to. NSCocoaErrorDomain is Apple's umbrella domain for errors generated by the Cocoa framework, which is the foundational layer Apple uses across iOS, macOS, watchOS, tvOS, and visionOS for file handling, user defaults, archiving, and many other system services. errormessage=could not find the specified shortcut is the human-readable description of what went wrong. errorcode=4 is the specific numeric error code inside the NSCocoaErrorDomain family.

Error code 4 in NSCocoaErrorDomain is officially defined by Apple as NSFileNoSuchFileError — the system tried to find a file, directory, or resource and could not find it at the location it expected. In the context of Apple Shortcuts (the automation system Apple ships with iOS, iPadOS, macOS, and watchOS), this means the system, an automation, an app, or a piece of code referenced a Shortcut by name or identifier, and that Shortcut no longer exists where the reference points. The Shortcut may have been deleted, renamed, never synced from iCloud, corrupted in the local Shortcuts database, or referenced incorrectly by a developer in code.

The error is not a sign that your device is broken, that Apple Shortcuts is permanently malfunctioning, or that you have a virus or malware. It is a routine "reference not resolved" error, the same shape as a 404 on the web. The fix is to either point the reference at a Shortcut that exists or to recreate the missing Shortcut.

When does this error appear?

Six common scenarios produce the error, each with a different fix.

• You ran a Shortcut from the Shortcuts app that depends on another Shortcut as a sub-routine, and the sub-routine Shortcut has been deleted or renamed.
• A HomeKit automation tries to run a Shortcut as one of its actions, and the Shortcut has been deleted or never synced from another device.
• An Apple Watch automation references a Shortcut that exists on the iPhone but has not synced to the Watch yet, or has been removed.
• A third-party app integration (an app's "Open in Shortcuts" feature, a widget, or a Lock Screen complication) references a Shortcut by name and the Shortcut has been renamed or deleted.
• You are a developer using the AppIntents framework (the modern replacement for SiriKit) and your code tries to resolve a shortcut that does not exist in the user's library.
• You are a developer using the older Intents framework or NSUserActivity and the activity userInfo references a Shortcut identifier that has been removed.

The next sections cover each scenario in detail. Skip to the one that matches what you are seeing.

Fix for iOS and macOS Shortcuts app users

This is the most common case. The Shortcuts app shows the error, or you tap a Shortcut on the Home Screen, in a widget, or via Siri, and the error pops up. Try these steps in order; most users find the fix within the first three.

Step 1: Force quit and reopen the Shortcuts app

On iPhone or iPad, swipe up from the bottom of the screen (or double-press the Home button on older devices) and swipe the Shortcuts app card up to close it. Reopen the app. On Mac, right-click the Shortcuts icon in the Dock and choose Quit, then reopen.

Step 2: Check iCloud Shortcuts sync

If the Shortcut you are looking for was created on another device, it may not have synced yet.

• On iPhone or iPad: Settings → tap your name at the top → iCloud → See All → scroll to Shortcuts → make sure the toggle is on.
• On Mac: System Settings → Apple ID → iCloud → tap "Show More Apps" if needed → make sure Shortcuts is on.
• Wait 5 to 10 minutes after enabling iCloud Shortcuts for the first time before testing again — initial sync can take several minutes.

Step 3: Search the Shortcuts app for the name in the error

Open the Shortcuts app and use the search bar at the top to look for any partial fragment of the Shortcut name that was referenced. If you find a renamed version, the automation that referenced the old name needs to be updated. If you do not find it at all, the Shortcut was deleted and either needs to be restored from a backup or recreated.

Step 4: Restart the device

On iPhone with Face ID, press and hold the side button and one volume button until the slider appears, then drag to power off. Wait 30 seconds, then hold the side button to turn it back on. On Mac, choose Apple menu → Restart. A restart clears in-memory caches that occasionally hold stale Shortcut references.

Step 5: Recreate the missing Shortcut

If the original Shortcut is genuinely gone, the only fix is to recreate it. Open the Shortcuts app → tap the + button → build the Shortcut with the same name as the one referenced in the error. Any automation, widget, or third-party reference looking for that name will then resolve successfully.

Step 6: Sign out and back into iCloud (last resort)

Only if steps 1 through 5 have not worked: on iPhone or iPad, Settings → your name → Sign Out at the bottom. Wait two minutes, then sign back in. This forces a full re-sync of every iCloud-backed service including Shortcuts. Note that you may lose some local app state, so back up first.

Fix for HomeKit and Home app users

HomeKit automations sometimes run a Shortcut as one of the action types. When the Shortcut is deleted or renamed, the automation breaks and shows the error.

1. Open the Home app on iPhone, iPad, or Mac.
2. Tap or click the Automation tab at the bottom.
3. Find the automation that is failing — it usually shows a small warning icon or an "Error" badge.
4. Tap the automation to edit it.
5. Scroll to the action that says "Run Shortcut" and shows the broken reference.
6. Either choose a new Shortcut to run, recreate the original Shortcut with the same name, or delete the action entirely.
7. Tap Done and run the automation manually to confirm the fix.

If you have many automations referencing the same missing Shortcut, recreating the Shortcut with the original name fixes them all at once.

Fix for Apple Watch users

The Apple Watch has its own Shortcuts library, and Shortcuts created on iPhone sync to the Watch only if the iPhone is unlocked, both devices are on the same Wi-Fi or close enough for Bluetooth, and the Shortcuts iCloud toggle is on.

1. On iPhone, open the Watch app.
2. Tap Shortcuts in the list of installed apps.
3. Confirm the toggles for Show on Apple Watch and Sync Shortcuts are on.
4. Wait 2 to 5 minutes after toggling on for sync to complete.
5. If a Shortcut still does not appear on the Watch, run the Shortcut once on the iPhone first — this sometimes triggers a re-sync to the Watch.
6. If a complication on the Watch face references a missing Shortcut, edit the watch face and replace the complication.

Fix for Swift developers using AppIntents

AppIntents is Apple's modern framework (introduced in iOS 16 and macOS Ventura) for exposing app functionality to Shortcuts, Siri, Spotlight, and the Action Button. If your AppIntent or AppShortcut tries to resolve a Shortcut that does not exist, you get the NSCocoaErrorDomain code 4 error.

The pattern that causes the error

The common mistake is assuming a referenced Shortcut exists without checking first.

import AppIntents

struct OpenSpecificShortcut: AppIntent {
    static var title: LocalizedStringResource = "Open Specific Shortcut"

    @Parameter(title: "Shortcut Name")
    var shortcutName: String

    func perform() async throws -> some IntentResult {
        // PROBLEM: this throws NSCocoaErrorDomain code 4 when the Shortcut
        // does not exist in the user's library
        let shortcut = try await INVoiceShortcutCenter.shared
            .getVoiceShortcut(withIdentifier: shortcutName)

        // Subsequent code never runs because the error has already thrown
        return .result()
    }
}

The pattern that fixes it

Always check for the Shortcut's existence before using it, and provide a useful error to the user when it is missing.

import AppIntents
import Intents

struct OpenSpecificShortcut: AppIntent {
    static var title: LocalizedStringResource = "Open Specific Shortcut"

    @Parameter(title: "Shortcut Name")
    var shortcutName: String

    func perform() async throws -> some IntentResult {
        // Fetch all available shortcuts safely
        let allShortcuts: [INVoiceShortcut] = await withCheckedContinuation { cont in
            INVoiceShortcutCenter.shared.getAllVoiceShortcuts { shortcuts, error in
                if let error = error as NSError? {
                    print("Failed to fetch shortcuts: \(error.localizedDescription)")
                    cont.resume(returning: [])
                    return
                }
                cont.resume(returning: shortcuts ?? [])
            }
        }

        guard let match = allShortcuts.first(where: {
            $0.shortcut.userActivity?.title == shortcutName
        }) else {
            // Throw a domain-specific error rather than letting the
            // NSCocoaErrorDomain bubble up
            throw ShortcutError.notFound(name: shortcutName)
        }

        // Use the matched shortcut
        _ = match
        return .result()
    }
}

enum ShortcutError: Error, CustomLocalizedStringResourceConvertible {
    case notFound(name: String)

    var localizedStringResource: LocalizedStringResource {
        switch self {
        case .notFound(let name):
            return "Could not find a shortcut named \(name) in your library."
        }
    }
}

Handling the error on the main actor for UI feedback

When the error fires from a UI action (a button tap, a SwiftUI view), surface it to the user rather than letting it crash silently.

import SwiftUI
import AppIntents

struct ContentView: View {
    @State private var errorMessage: String?

    var body: some View {
        VStack {
            Button("Run My Shortcut") {
                Task {
                    do {
                        try await OpenSpecificShortcut(
                            shortcutName: "Morning Routine"
                        ).perform()
                    } catch let error as NSError where
                        error.domain == NSCocoaErrorDomain && error.code == 4 {
                        // The exact error this article is about
                        errorMessage = "The Morning Routine shortcut could not be found. Please recreate it in the Shortcuts app."
                    } catch {
                        errorMessage = "Unexpected error: \(error.localizedDescription)"
                    }
                }
            }
            if let msg = errorMessage {
                Text(msg).foregroundColor(.red)
            }
        }
    }
}

Fix for older Intents and NSUserActivity references

Pre-iOS-16 apps used SiriKit's INVoiceShortcut and NSUserActivity to integrate with Shortcuts. The same NSCocoaErrorDomain code 4 error fires when the activity identifier references a Shortcut that no longer exists.

import Intents

func runShortcutByIdentifier(_ identifier: String) {
    INVoiceShortcutCenter.shared.getVoiceShortcut(
        with: UUID(uuidString: identifier) ?? UUID()
    ) { shortcut, error in
        if let error = error as NSError? {
            if error.domain == NSCocoaErrorDomain && error.code == 4 {
                // The specific error this article addresses
                DispatchQueue.main.async {
                    showAlert(
                        title: "Shortcut Missing",
                        message: "This shortcut is no longer available. Please reconfigure the integration."
                    )
                }
                return
            }
        }
        guard let shortcut = shortcut else { return }
        // Use the shortcut
        _ = shortcut
    }
}

Terminal commands for advanced debugging on macOS

If you are developing on a Mac and want to see the underlying error in real time, the following terminal commands stream system logs and inspect the Shortcuts database directly.

Watch live Shortcuts logs

# Stream every log message tagged with the Shortcuts subsystem
log stream --predicate 'subsystem == "com.apple.shortcuts"' --info --debug

Run a failing Shortcut while this command is active and watch the exact error messages flow past.

Filter for the specific error code

# Search the last hour for NSCocoaErrorDomain code 4
log show --predicate 'eventMessage CONTAINS "NSCocoaErrorDomain" AND eventMessage CONTAINS "code: 4"' --last 1h

Inspect the Shortcuts SQLite database

# Open the Shortcuts database in read-only mode
sqlite3 -readonly ~/Library/Shortcuts/Shortcuts.sqlite

# Once inside the sqlite3 prompt, list every Shortcut by name
.headers on
.mode column
SELECT Z_PK, ZNAME FROM ZSHORTCUT ORDER BY ZNAME;

# Find a specific Shortcut by name
SELECT Z_PK, ZNAME, ZIDENTIFIER FROM ZSHORTCUT WHERE ZNAME LIKE '%Morning%';

# Exit the sqlite3 prompt
.exit

If the Shortcut name you expect does not appear in this list, it genuinely does not exist in your local database — which confirms the diagnosis.

Inspect Shortcuts app preferences

# Print Shortcuts app preferences
defaults read com.apple.shortcuts

# Reset preferences (use with caution — backs up first)
defaults export com.apple.shortcuts ~/Desktop/shortcuts-prefs-backup.plist
defaults delete com.apple.shortcuts

Reset the Shortcuts app (nuclear option)

# Quit Shortcuts first
osascript -e 'quit app "Shortcuts"'

# Move the Shortcuts container to a backup location
mv ~/Library/Shortcuts ~/Library/Shortcuts.backup-$(date +%Y%m%d)

# Reopen Shortcuts — it will rebuild from iCloud if iCloud Shortcuts is on
open -a Shortcuts

Only run the reset command if you have iCloud Shortcuts enabled. Without iCloud, this deletes every local Shortcut. The backup directory at the same path lets you restore if needed.

The same error in other languages

Apple localises this error message to the device's system language. The error code, error domain, and fix are identical regardless of locale.

All eight variants share the same NSCocoaErrorDomain identifier and error code 4. If you have switched device languages or you are debugging an app for international users, the fixes in this guide apply unchanged across every locale.

Prevention tips — for developers and power users

• Reference Shortcuts by stable identifier, not by name. If your app or automation references Shortcuts, store the Shortcut's identifier rather than its display name. Renames will not break the reference.
• Always handle the not-found case in code. Wrap every Shortcut resolution in a do-catch or a guard with a specific error type. Never let the raw NSCocoaErrorDomain bubble up to the user.
• Test the missing-Shortcut path during development. Delete the referenced Shortcut from the simulator and confirm your app handles the failure gracefully.
• Document the Shortcuts your app or automation depends on. If your app's onboarding tells the user to install a specific Shortcut, link directly to a hosted version with a known name and provide one-tap install.
• Use AppShortcuts where possible. The newer AppShortcut API in AppIntents lets you declare intents that ship with your app rather than relying on user-created Shortcuts, eliminating the not-found case entirely for those flows.
• Subscribe to iCloud sync notifications. If your app depends on iCloud-synced Shortcuts, listen for NSPersistentCloudKitContainer notifications and refresh references after sync completes.

Frequently Asked Questions

What is NSCocoaErrorDomain?

NSCocoaErrorDomain is Apple's main error domain for the Cocoa framework — the foundational layer used by iOS, macOS, watchOS, tvOS, and visionOS. It groups error codes for file handling, user defaults, archiving, formatting, and many other system services into one umbrella. When you see "errordomain=nscocoaerrordomain" in an error message, the error is coming from one of these system-level subsystems rather than from a third-party library or your own code.

What does error code 4 mean specifically?

Error code 4 inside NSCocoaErrorDomain is officially defined as NSFileNoSuchFileError. The system tried to find a file, directory, or named resource and could not find it at the expected location. In the context of Apple Shortcuts, "specified shortcut" is the resource the system was looking for, and "not found" means it has been deleted, renamed, never synced, or referenced incorrectly.

Will this error damage my iPhone, iPad, or Mac?

No. NSCocoaErrorDomain error code 4 is a routine "reference not resolved" error, the same shape as a 404 on the web. It does not indicate hardware damage, virus infection, jailbreak compromise, or permanent software failure. The fix is to either point the broken reference at a Shortcut that exists or recreate the missing Shortcut.

Why did this start happening after I updated iOS or macOS?

Major iOS, iPadOS, and macOS updates occasionally migrate the Shortcuts database to a new schema or refresh iCloud sync state. Shortcuts that were referenced by name or identifier across the upgrade can briefly fail to resolve while the migration completes. Wait 30 to 60 minutes after the upgrade with Wi-Fi connected and the device unlocked, then test again. If the error persists, follow the steps in the iOS and macOS fix section.

How do I figure out which specific Shortcut the error is about?

The error message itself rarely names the missing Shortcut. To find it, open the Console app on macOS (or use the log stream terminal command shown earlier) and watch for the error in real time while you reproduce the triggering action. The system log usually includes the Shortcut identifier or name in the surrounding log lines. On iOS, the easiest path is to check which automation, widget, or app fired the error and inspect its configuration.

Will resetting my Shortcuts app fix it?

Resetting the Shortcuts app (or signing out of iCloud and back in) is the nuclear option and will fix the error in cases where the local Shortcuts database is corrupted. The trade-off is that it wipes local Shortcuts that have not synced to iCloud. Always export important Shortcuts via the Shortcuts share menu before resetting, and confirm iCloud Shortcuts is enabled so the reset rebuilds from cloud rather than deleting permanently.

As a developer, what is the best practice for handling this error?

Wrap every Shortcut resolution in a do-catch block and check explicitly for NSCocoaErrorDomain with code 4. Surface a domain-specific error to the user that includes the missing Shortcut name and a clear next step. Never let the raw NSError bubble up to the user as a crash or unhandled exception — it is a recoverable error and should be handled gracefully. The Swift code examples in this guide show the exact pattern to use.

Will Apple fix this in a future iOS or macOS release?

The error itself is not a bug — it is the system correctly reporting that a referenced Shortcut does not exist. Apple does occasionally improve the user-facing language and the recovery suggestions in the error dialog, but the underlying error code 4 in NSCocoaErrorDomain is a designed-in part of the API and is not going away. The right approach is to handle the error gracefully in code and to ship clear recovery instructions to users.