macOS
Table of Contents
Shortcuts User Guide
- Welcome
-
- Intro to Shortcuts
- Discover shortcuts in the Gallery
-
- Run a shortcut from the app
- Run shortcuts with Siri
- Run shortcuts from a widget
- Run a shortcut from Spotlight
- Launch a shortcut from another app
- Run shortcuts from Apple Watch
- Adjust privacy settings
-
- Intro to how shortcuts work
- The flow of content
- Action connections
- Control the flow of actions
- Shortcut completion
- The Content Graph engine
-
- Create a custom shortcut
- Ideas for custom shortcuts
-
- Navigate the action drawer
- Order of actions
- Get actions
- Transform actions
- Share actions
- Test your actions
- Import shortcuts
-
- Intro to editing shortcuts
- Organize shortcuts in folders
- Change the layout
- Reorder shortcuts
- Rename shortcuts
- Modify shortcut icons
- Duplicate shortcuts
- Delete shortcuts
- Sync shortcuts
- Share shortcuts
- Add import questions to shared shortcuts
-
-
- Intro to variables
- Variable types
- Use variables
- Adjust variables
- Use list actions
- Use the Choose from Menu action
- Use If actions
- Use Repeat actions
-
- Intro to Find and Filter actions
- Add filter parameters
-
- Intro to using prompts
- Use the Ask for Input action
- Use the Ask Each Time variable
- Use the Show Alert action
- Use the Show Notification action
- Input types
- Limit the input for a shortcut
- Receive onscreen items
- Advanced Shortcuts settings
- Run shortcuts from the command line
-
- Intro to the Run JavaScript on Webpage action
- Use the Run JavaScript on Webpage action
-
- Intro to URL schemes
- Open, create, and run a shortcut
- Run a shortcut from a URL
- Open or search the Gallery from a URL
- Use x-callback-url
- Use another app’s URL scheme
-
- Intro to web APIs
-
- What’s an API?
- Request your first API
-
- Intro to using JSON
- Parsing JSON
- Handling lists
- Get Dictionary Value action
- Create contacts
-
- API limitations
- Format Date timestamps
- Dictionaries
-
- About date and time formatting
- Date and time formats
- Dates as written language
- Technical standards
- Custom date formats
-
- Copyright
What’s a shortcut?
A shortcut provides a quick way to get things done with your apps, with just a click or by asking Siri.
Shortcuts can automate a wide variety of things—for example, getting directions to the next event on your Calendar, moving text from one app to another, generating expense reports, and more.
Based on how you use your Apple devices—your app usage and your browser, email, and messaging history—Siri suggests simple, useful shortcuts that you can quickly click to run. Once you create a shortcut, you can activate Siri, then say the shortcut’s name to run it.
The Shortcuts app
In addition to running the simple shortcuts suggested by Siri, you can use the Shortcuts app to add ready-made or custom shortcuts to your devices. The app lets you combine multiple steps across multiple apps to create powerful task automations.
After you add shortcuts from the Gallery or create your own, you can run them on your Mac from:
The Shortcuts app
Siri
The macOS Finder, including from Spotlight, the menu bar, the Actions pop-up menu, the Services menu, and the Dock.
The Touch Bar of a MacBook Pro
A keyboard shortcut
The command line
You can also run the shortcuts you create on a Mac on an iOS or iPadOS device. See Run a shortcut on other Apple devices.
What’s an action?
An action is the building block of a shortcut. Each shortcut comprises a series of actions, and each action is a single step that performs a particular function. For example, a shortcut that shares an animated GIF might contain three consecutive actions: Get Latest Photos grabs the latest photos that you took on your device, Make GIF uses those photos to build an animated GIF, and Send Message automatically sends the GIF to your recipients.
Actions represent the best features of the apps on your Apple devices, broken out into smaller parts. With hundreds of actions, there are a variety of individual steps you can chain together to build shortcuts.
See Intro to how shortcuts work on Mac and Navigate the action list in Shortcuts on Mac.
Where are shortcuts stored?
In the Shortcuts app, shortcuts are organized in collections in the app sidebar:
All Shortcuts: Contains all of your shortcuts and shortcuts available in apps.
Share Sheet: Contains shortcuts that are available in the share sheet of another app.
Quick Actions: Contains shortcuts that appear in the Quick Actions menu in the macOS Finder.
Menu Bar: Contains shortcuts that appear in the Shortcuts menu in the macOS menu bar.
When you tap a collection name in the sidebar, all shortcuts in that collection are shown in a grid array. Each shortcut is represented by a rounded rectangle that has a title, an icon, and a color. Click to run the shortcut, or double-click the shortcut to see the actions contained inside.
Thanks for your feedback.