Custom Actions
Turn a prompt you use all the time into a one-click AI action, or search any website with a URL action.
All of this lives in the menu bar icon › Settings… › Actions. There you can turn actions on or off, drag them into the order you like (or use Move Up / Move Down), and edit or delete them. Restore All Defaults… puts the list back the way it was.
AI actions
Click New AI Action… and fill in:
- Name — what shows when you hover over the icon.
- Icon — pick a common icon, type an SF Symbol name (like
sparkles), or use one or two characters (likeT). - Prompt — what to ask the AI. Write
{text}where the selected text should go; Insert {text} adds it for you. If you leave it out, the selected text is added to the end of the prompt. - Output — where the result goes:
- Show in panel — read it in the result panel, with Copy and Replace buttons
- Replace selection — swap the selected text for the result right away
- Copy to clipboard — copy the result without showing anything
- Provider and Model — leave them on the default provider, or pick a specific one for this action.
Prompt ideas
Write as email
Rewrite the following as a short, polite email. Keep the meaning and the language of the original.
{text}Fix grammar only
Fix spelling and grammar mistakes in the text below. Don't change the wording otherwise. Reply with the corrected text only.
{text}Explain like I’m new to this
Explain this in plain words for someone new to the topic, in 3–5 sentences:
{text}Make it a to-do list
Turn this into a short to-do list. One task per line, starting with a verb.
{text}The built-in Translate, Explain, Summarize and Polish actions can be edited the same way. If you change one and want the original back, open it and click Restore Default.
URL actions
A URL action opens a web address with your selection in it — handy for searching a site you use often.
Click New URL Action…, give it a name and an icon, and enter a URL template with {text} where the selection goes. The text is encoded for URLs automatically, so spaces, Chinese characters and symbols all work.
Examples
| Name | URL template |
|---|---|
| Wikipedia | https://en.wikipedia.org/w/index.php?search={text} |
| GitHub | https://github.com/search?q={text}&type=code |
| MDN | https://developer.mozilla.org/search?q={text} |
| YouTube | https://www.youtube.com/results?search_query={text} |
| Google Maps | https://www.google.com/maps/search/{text} |
| Google Translate | https://translate.google.com/?sl=auto&tl=en&text={text} |
URL actions don’t need an AI provider.