• Products
  • Documentation
  • Resources

Configure shortcut links

Starting on June 6, 2024, we’re deprecating shortcuts and converting them to Smart Links in the content tree. For more information on the timeline for these changes, see our announcement in the Atlassian Community.

New editor
New Confluence Cloud editor toolbar
Legacy editor
Image highlights the unique tools that make the toolbar in the legacy editor different than the one in the new editor

Shortcut links provide a quick way of linking to resources that are frequently referenced from Confluence. When you create a shortcut link, you assign a key to a URL so that when editing, a user can type just the key instead of the complete URL.

Example: creating a shortcut to Google

Most Google searches look like this: http://www.google.com/search?q=. If you create a shortcut for this search with the key 'google', every time a user needs to use http://www.google.com/search?q=searchterms, they can just type [searchterms@google] instead.

Shortcut links are created and maintained by Confluence administrators from the administration console.

To create a shortcut link:

  1. Select the wheel icon () in the top-right corner to open Confluence administration.

  2. Find Settings > Configurationin the left-hand navigation.

  3. Select Shortcut links.

  4. Enter a Key for your shortcut.
    This is the shortcut name a user will use to reference the URL.

  5. Enter the Expanded Value.
    This is the URL for the link. You can use '%s' in the URL to specify where the user's input is inserted. If there is no '%s' in the URL, the user's input will be put at the end.

  6. Enter a Default Alias.
    This is the text of the link which will be displayed on the page where the shortcut is used, with the user's text being substituted for '%s'.

  7. Click Submit.

To delete a shortcut link, select Delete at the end of the row containing the shortcut.

Enter a shortcut link on the Advanced tab of the Insert Link dialog.

Specify in the link what should be appended to the end of the shortcut URL, followed by an at sign (@) and the key of the shortcut. Shortcut names are case-insensitive. So, for example, using the key shown in the example above:

To link to...

Type this

Resulting URL


a Google search

Atlassian Confluence@Google


Atlassian Confluence@Google



Still need help?

The Atlassian Community is here for you.