# Quicklinks
> Available on: Mac, Windows, iOS
Turn any URL into a keyboard shortcut with Raycast Quicklinks — open sites, trigger searches, and jump to deep links across all your devices.
Quicklinks let you save frequently used URLs, file paths, and deeplinks so you can open them instantly from Root Search. Whether it's a web search, a project folder in your IDE, a Spotify playlist, or a Notion page, Quicklinks turn multi-step navigation into a single action. In v2, Quicklinks gain support for tagging, pinning, and the new `{calculator}` [dynamic placeholder](/dynamic-placeholders).
> [!TIP]
> Open Quicklinks by searching for "Search Quicklinks" or "Create Quicklink" in Root Search. Your Quicklinks also appear directly in Root Search results alongside commands and applications.
## Creating a Quicklink
To create a new Quicklink:
1. Open Raycast and search for **Create Quicklink**
2. Enter the **Link**: a URL, file path, or deeplink
3. Give it a recognizable **Name** and optionally choose an **Icon**
4. On macOS, optionally choose an **Application** to open the link with (e.g., open a folder in VS Code instead of Finder)
5. **New** Optionally add **Tags** to organize your Quicklinks into groups
### What can a Quicklink open?
Quicklinks support a wide range of link types:
- **Web URLs**: `https://github.com`, `https://figma.com/file/...`
- **File & folder paths**: `~/Projects/my-app` (macOS) or `C:\Projects\my-app` (Windows)
- **Deeplinks**: `spotify://playlist/...`, `slack://channel/...`
- **Search queries**: use dynamic arguments to build parameterized search URLs (see below)
### Auto Fill
When creating a Quicklink on macOS, the link field can be automatically populated from your active browser tab or clipboard. This requires Automation permissions and works with Safari, Chrome, and other major browsers.
## Dynamic Placeholders
Quicklinks become much more powerful with [dynamic placeholders](/dynamic-placeholders). These are special tokens that get replaced with live data when the Quicklink is opened. Press `{` while editing a Quicklink to see all available placeholders.
### Available Placeholders
- `{argument}`: prompts for user input when the Quicklink is opened. You can use up to 3 arguments per Quicklink and customize each with a name and default value.
- `{clipboard}`: inserts the current clipboard contents
- `{date}`, `{time}`, `{datetime}`: inserts the current date, time, or both
- `{day}`: inserts the current day of the week
- `{uuid}`: generates a random unique identifier
- **New** The `{calculator}` placeholder is now available in Quicklinks. It evaluates a math expression inline when the Quicklink is opened. This placeholder is also available in Snippets and AI Commands.
### Arguments
Arguments are the most powerful placeholder type. They turn a static Quicklink into an interactive one that prompts you for input before opening. Each argument can have a custom name and a default value.
For example, a Google Translate Quicklink might use:
```
https://translate.google.com/?sl={argument name="source language" default="auto"}&tl={argument name="target language"}&text={argument name="word"}&op=translate
```
When you open this Quicklink, Raycast prompts you for the source language, target language, and word to translate, with "auto" pre-filled as the default source language.
## Searching & Managing Quicklinks
The **Search Quicklinks** command gives you a central view of all your Quicklinks. From here you can:
- Search by name to find a specific Quicklink
- **New** Filter by tag to narrow down your collection ( `P`)
- Open the Action Panel ( `K`) to access additional actions
### Available Actions
With a Quicklink selected, open the Action Panel to access:
- **Edit**: modify the link, name, icon, or tags
- **Duplicate**: create a copy to use as a starting point
- **Copy Name** / **Copy Link**: copy the Quicklink's name or URL to your clipboard
- **Create New**: start creating a new Quicklink
- **Delete**: remove the Quicklink
## Tags
**New** Quicklinks now support tagging. Tags let you organize your Quicklinks into logical groups: for example, by project, client, or purpose. Assign one or more tags when creating or editing a Quicklink, then filter by tag in the Search Quicklinks view. This was a popular community request.
## Pinning
**New** Quicklinks can now be pinned. Pinned Quicklinks appear at the top of Root Search results, giving you instant access to your most-used links without typing anything. Pin a Quicklink from the Action Panel or from Settings.
## Shared Quicklinks (Teams)
With Raycast for Teams, you can create shared Quicklinks that are available to everyone on your team. This is ideal for frequently accessed resources: internal dashboards, documentation, staging environments, design files, and more. Shared Quicklinks appear alongside your personal Quicklinks and can be managed from the Raycast Teams dashboard.
More about shared Quicklinks
You can share Quicklinks with members of your organization. It's an easy way to access information and is ideal for links to your company's roadmap, dashboards, or other resources.
> [!NOTE]
> You must enable organizations in Raycast and have created your first organization before you can create a shared Quicklink.
**Create Shared Quicklink**
1. Search for the **Create Quicklink** command in Raycast.
2. In the form, select your Organization.
3. Enter a name and URL for the Quicklink.
4. Press `↵` to create and publish the Quicklink.
Your Quicklink will now be available in Raycast for all of your organization's members. Shared Quicklinks display the organization's icon on the right-hand side of the item.
Shared Quicklinks are synced automatically between all organization members. Any changes made by one member will be propagated to all others.
**Managing Shared Quicklinks**
To manage shared Quicklinks, use the **Manage Quicklinks** command. By default you will see a list of your personal Quicklinks — these are stored locally in Raycast and not synced. To view your organization's shared Quicklinks, choose your organization from the filter menu at the top-right of the window.
You can perform various actions on the selected Quicklink using the Action Panel ( `K`), including **Edit**, **Duplicate**, **Move** (to another organization), or **Delete**. You'll be prompted to confirm before a destructive action such as move or delete. You can also create a new Quicklink using the **Create Quicklink** action.
**Settings**
You can also view and manage your shared Quicklinks in **Raycast Settings → Quicklinks**. Your organization's Quicklinks will appear in a separate group. You can perform actions on the selected Quicklink via the right-click context menu. Select the organization's group to create a new Quicklink from scratch or from Raycast's built-in library of pre-defined Quicklinks.
## Importing Quicklinks
Raycast supports importing Quicklinks from JSON files. This is useful for sharing Quicklink collections with teammates or migrating from another setup. To import, search for **Import Quicklinks** in Root Search and select your JSON file.
More about importing Quicklinks
**JSON Format**
The JSON file must be an array of Quicklink objects. Each object supports the following fields:
- `name` — Quicklink title. Type: `String` (required)
- `link` — Quicklink URL. Type: `String` (required)
- `iconName` — Quicklink icon. Type: `String` (optional)
- `openWith` — Target app to open the Quicklink. Type: `String` (optional)
If no app is specified with `openWith`, the link will open in the default web browser. Deeplinks will be routed by the browser.
If no icon is specified with `iconName`, the default Quicklink icon will be used.
```json
[
{
"link": "https://duckduckgo.com/?q={argument}",
"name": "Search DuckDuckGo"
},
{
"openWith": "Finder",
"iconName": "folder-16",
"link": "~/Downloads",
"name": "Downloads"
},
{
"openWith": "Music",
"link": "https://music.apple.com/gb/station/apple-music-1/ra.978194965",
"name": "Apple 1"
},
{
"link": "shortcuts://run-shortcut?Name={Test}",
"name": "Run Shortcut"
}
]
```
After the import completes, you will see how many Quicklinks were added and how many duplicates were skipped. If a Quicklink has the same title and content, it is considered a duplicate.
## Settings
Quicklink settings are available in **Raycast Settings → Quicklinks**. Here you can:
- Toggle link previews on or off
- Assign hotkeys and aliases to individual Quicklinks or to the Search/Create commands
- **New** Edit your Prefer Existing Tabs. When you open a Quicklink that points to a URL, Raycast first checks if that URL is already open in one of your browser tabs. If it is, Raycast switches to that tab instead of opening a new one. Keeping your tab count down and avoiding duplicates.
## Use Cases & Examples
Here are some practical ways to use Quicklinks:
- **Search engines**: `https://google.com/search?q={argument name="query"}`, search Google from Raycast
- **GitHub repo**: `https://github.com/{argument name="org"}/{argument name="repo"}`, jump to any repo
- **Project folder**: `~/Projects/my-app` opened in VS Code, one keypress to start coding
- **Internal tools**: dashboard URLs, staging environments, admin panels
- **Translation**: a Google Translate Quicklink with arguments for source language, target language, and word
- **Daily standup**: a Quicklink to your team's standup Zoom/Meet link, pinned for one-click access
## Settings
Open Raycast Settings (`⌘` `,`) and select **Quicklinks** from the sidebar to configure how Quicklinks behave and manage your library. Use the toggle in the top-right corner to enable or disable the Quicklinks feature entirely.
- **Show Link Previews**: Display a preview of the destination URL when browsing your Quicklinks in Root Search. Turn it off if you prefer a cleaner list without preview thumbnails.
- **Prefer Existing Tabs**: When opening a Quicklink, Raycast checks if the URL is already open in your browser and activates that tab instead of opening a new one. Helpful for avoiding duplicate tabs when you frequently revisit the same links.
### Commands
Assign aliases and hotkeys to the Quicklinks commands you use most:
- **Create Quicklink**: Opens the Quicklink editor so you can save a new link directly from Settings. Toggle **Autofill selected text** to pre-fill the URL field with whatever text is currently selected in another app.
- **Export Quicklinks**: Save your Quicklinks to a file for backup or sharing.
- **Import Quicklinks**: Import Quicklinks from a previously exported file.
- **Search Quicklinks**: Find and open a Quicklink from your library.
### Quicklinks
Below Commands, you'll find your full Quicklinks library. This is where both Personal Quicklinks (the ones you've created locally) and Team Quicklinks (shared via Raycast for Teams) are listed together. From here you can:
- Click **Create Quicklink** to add a new entry without leaving Settings.
- Assign an alias or hotkey to any Quicklink for faster access.
- Use the **...** menu next to a Quicklink to edit, duplicate, or delete it.
> [!TIP]
> Use the search field at the top of the Quicklinks list to quickly filter by name. For example, typing `file` surfaces your Finder File Quicklink along with anything else matching the term. This is the fastest way to manage a large library without scrolling.
## Troubleshooting
Quicklink doesn't open or opens the wrong app
- Verify the URL or path is correct and accessible.
- On macOS, check that the correct application is selected in the "Open With" field.
- For deeplinks (e.g., `spotify://`), make sure the target app is installed.
Arguments aren't being substituted
- Check the placeholder syntax. Arguments must use curly braces: `{argument name="..."}`.
- You can use a maximum of 3 arguments per Quicklink.
Still having issues?
If none of the above resolves your issue, please reach out to our support team. Include the following:
1. **A screen recording** showing the issue. On macOS, press `⇧` `5` to open the screen recording tool. On Windows, press `Win` + `Alt` + `R` to start recording with the Xbox Game Bar, or use the Snipping Tool.
2. **The Quicklink URL or path** (with any placeholders).
3. **Your OS version** and **Raycast version** (found in **Raycast Settings → About**).
4. **Your Raycast logs**: Use the built-in **Copy Raycast Logs** command to copy your latest log files to the clipboard, or **Reveal Raycast Logs** to open your log folder. Search for either command in Raycast.
---
## Need Help?
Contact Raycast Support if you have any questions or would like help with Quicklinks. Use the **Send Feedback** command directly in Raycast to report bugs and billing issues, log feature requests, or any other queries you would like to speak to us about.
You can view all Raycast Support contact options at https://manual.raycast.com/contact-support