How to Edit Shortcuts on iPhone: Full Guide

Editing a Shortcut on your iPhone lets you change what it does, how it looks, and when it runs — without rebuilding it from scratch. You can adjust the actions, reorder steps, change the name and icon, or tweak the settings that control how the shortcut is triggered. This guide walks through the entire editing process in the Shortcuts app, from opening the editor to testing your changes.

What You’ll Need

An iPhone or iPad running iOS 13 or later (the Shortcuts app is built-in from iOS 13 onward).
At least one existing shortcut — either one you created or one you downloaded from the Gallery or a shared link.
iCloud signed in (optional, but required to sync shortcuts across devices).

Step-by-Step

Open the Shortcuts app. Tap the Shortcuts icon on your Home Screen or in your App Library. The app shows two main tabs at the bottom: “Shortcuts” and “Automations.” Make sure you’re on the Shortcuts tab.
Find the shortcut you want to edit. Your shortcuts appear as a grid or list. Tap once on the shortcut’s icon to run it — that’s not what you want here. Instead, press and hold on the shortcut until a context menu appears. Release, then tap Edit from that menu. This opens the shortcut in the action editor.
Understand the editor layout. The editing screen shows the shortcut’s name at the top, a preview area, and a vertical list of actions. Each action is a card with a title, an icon, and its own settings. The first card is always the “Shortcut Name” card — this is where you can change the name, icon, and color.
Rename the shortcut. Tap the current name (e.g., “My Shortcut”) at the top of the editor. A text field appears. Type the new name, then tap Done on the keyboard. The name is used in the Shortcuts list, in Siri suggestions, and when you say the phrase to trigger it.
Change the icon and color. In the same top card, tap the current icon (the small square with a glyph). A picker opens with two tabs: Color and Glyph. Choose a color from the swatches, then switch to the Glyph tab and scroll or search for a new symbol. Tap a glyph to select it, then tap Done in the top-right corner.
Add a new action. To add a step, tap the + button at the bottom of the action list (or the “+” in a circle on the right side of the screen). A searchable list of actions appears, grouped by category like Apps, Scripting, and Web. Tap an action to insert it at the end of the shortcut. If you want it in a specific spot, drag it after inserting.
Reorder actions. Press and hold the drag handle (the three horizontal lines on the right side of an action card) and drag the action up or down. Release when it’s in the desired position. The order matters — actions run top to bottom, and each action can use the output of the ones above it.
Edit an action’s settings. Tap any action card to reveal its fields. For example, a “Get Current Weather” action lets you choose the location; a “Send Message” action lets you pick the recipient and message text. Some actions have a Show More button to reveal additional options like input filtering or error handling.
Remove an action. Tap an action to select it, then tap Delete at the bottom of the editor (or swipe left on the action and tap Delete). If you accidentally delete something, shake your iPhone and tap Undo to bring it back.
Duplicate an action. Tap an action to select it, then tap the duplicate icon (two overlapping squares) at the bottom of the editor. This copies the action with all its settings, placing it directly below the original.
Edit the shortcut’s settings. Tap the Settings icon (the sliders) in the top-right corner of the editor. Here you can toggle options like “Show in Share Sheet,” “Receive input from Share Sheet,” “Allow receiving shared input,” and “Use as Quick Action.” You can also add the shortcut to the Home Screen from this menu.
Test your changes. Tap the Play button (the triangle) in the top-right corner of the editor. The shortcut runs immediately. Watch for any action that shows an error or asks for input — that’s usually where something needs fixing.
Save and exit. Your changes are saved automatically as you edit. When you’re done, tap Done in the top-left corner to return to the main Shortcuts list. There’s no separate “save” button — editing is live.

Common Mistakes

Running the shortcut instead of editing it. A single tap runs it. You must press and hold to get the Edit option.
Forgetting that the top card is the name/icon card. People often look for a separate “rename” button and miss that the first card in the list is exactly that.
Not checking the input type. If a shortcut expects text but you give it an image, it will fail. Check the “Input” setting in the shortcut’s settings and the input type of the first action.
Breaking the flow with a wrong variable. When you delete an action that another action references, the remaining action may show a red “variable not found” error. You’ll need to re-select the variable.
Ignoring the “Ask Each Time” toggles. Many actions have a small “Ask Each Time” switch next to their fields. If it’s on, the shortcut will prompt you every time it runs — which might be annoying or exactly what you want.

Tips

Use the search bar in the action picker. Typing a keyword like “calendar” or “photo” filters the list instantly, saving a lot of scrolling.
Long-press an action to quickly copy, duplicate, or disable it without opening the full editor.
Disable an action temporarily. Tap the action, then toggle the switch at the top of its card. Disabled actions are grayed out and skipped when the shortcut runs — useful for testing without deleting.
Use folders to organize. In the main Shortcuts list, tap the “…” in the top-right, then “New Folder” to group related shortcuts. Editing a shortcut inside a folder works the same way.
Rename before you change the icon. If you rename a shortcut, Siri’s suggested phrase changes. If you’ve already set a custom Siri phrase, renaming won’t break it, but you’ll need to say the new name when adding a new phrase.
Check the “Show in Share Sheet” setting if your shortcut isn’t appearing in the share sheet. It’s off by default for new shortcuts.

Troubleshooting

I can’t edit a shortcut — the Edit option is grayed out. This happens when the shortcut is a “folder” or a “smart” automation. For automations, go to the Automations tab, tap the automation, and edit it there. For regular shortcuts, make sure you’re pressing and holding the shortcut icon itself, not a folder.

My changes don’t seem to save. The Shortcuts app saves automatically, but if the app crashes, changes since the last action might be lost. Force-quit the app (swipe up from the bottom and hold, then swipe the Shortcuts card away) and reopen it. If the problem persists, restart your iPhone.

An action shows a red error when I run the shortcut. Tap the red action to see the error message. Common fixes: re-select the variable, check that the input type matches, or ensure the app the action uses is installed and logged in.

The shortcut runs but does nothing. Check the first action — it might be waiting for input that never comes. Look for “Ask Each Time” prompts that might be hidden. Also, verify that the shortcut isn’t disabled (grayed out) at the top of the editor.

I deleted an action by mistake. Shake your iPhone immediately and tap Undo. If that doesn’t work, you can’t recover the deleted action, but you can re-add it from the action picker and reconfigure it.

Frequently Asked Questions

Can I edit a shortcut that I downloaded from the Gallery? Yes. Downloaded shortcuts are fully editable. Just press and hold and choose Edit. Some may have a “Setup” step that runs the first time — you can skip it and edit later.

How do I change the Siri phrase for a shortcut? In the editor, tap the Settings icon (sliders), then tap “Add to Siri.” Record a new phrase. If a phrase already exists, you’ll see it listed — tap it to change or delete it.

Can I edit a shortcut on my Mac? Yes, if you have macOS Monterey or later with the Shortcuts app. The interface is similar, and changes sync via iCloud. However, some iPhone-only actions (like those using the camera) may not work on the Mac.

Why can’t I drag actions on my iPhone? You need to press and hold the drag handle (three lines) for about a second until the action lifts, then drag. If it’s still not working, try using two fingers or restarting the app.

How do I delete a shortcut entirely? Press and hold the shortcut, tap Delete, then confirm. This cannot be undone, so double-check before confirming.

Can I edit the shortcut’s icon to a custom photo? No, the built-in glyph picker is the only option. You can’t use your own image as the icon, though you can add the shortcut to your Home Screen with a custom photo using “Add to Home Screen” in the settings.

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →