Smart Links in Confluence | Confluence Cloud | Atlassian Support (2024)

Smart Links make it easy to create, edit, and view work across Atlassian and third-party products.With Confluence, Jira, and other Atlassian products, every link is a Smart Link.

Smart Links in Confluence | Confluence Cloud | Atlassian Support (1)

Smart Links allow you to create and interact with links to:

  • Hover over links to display rich information and interact with link elements like changing the status of Jira issues

  • Control how links appear in pages you create with dynamic display options

  • Collaborate on tasks and projects without leaving the Confluence page

Most links (also known as hyperlinks and URLs) will automatically unfurl or convert into a Smart Link when you paste them in a Confluence page.

You can cancel this by using keyboard shortcuts:

  • For Mac: Cmd + Z

  • For Windows: Ctrl + Z

You can also select the link and choose your preferred display view from the Smart Link toolbar.

Create and insert links

Highlight words or phrases then use Cmd + Kfor Mac or Ctrl + K for Windows to convert them into links. You may also select the link icon from the top menu.

Link to headings or sections

To insert a link leading to a specific heading or section of a page:

  1. Hover over the heading until the link icon appears.

  2. Select the link icon. This will copy the URL of the heading link.

  3. Use the URL you copied to create the link.

Smart Links in Confluence | Confluence Cloud | Atlassian Support (2)

Link to a Confluence comment

To insert a link leading to a comment from Confluence page:

  1. Hover over the comment date until the link icon appears.

  2. Select the link icon. This will copy the URL of the heading link.

  3. Use the URL you copied to create the link.

Smart Links in Confluence | Confluence Cloud | Atlassian Support (3)

Link to an email address

To insert a link that will create a message directed to a specific email address:

  1. Use Cmd + Kfor Mac or Ctrl + K for Windows, or select the link icon(icon).

  2. Type ‘mailto:’ followed by the email address in the link field. For example: 'mailto:iamawesome@email.com'

  3. Choose the text to display.

  4. Select Insert.

Smart Links in Confluence | Confluence Cloud | Atlassian Support (4)

Link to an anchor

To link to an Anchor macro on the same page:

  1. Make note of the name of the anchor to which you want to link. The name is displayed on the anchor when editing the page.

  2. Highlight the text you want to use as the link.

  3. Select the link tool .

  4. Enter the name of the macro prefaced by a # symbol. If your Anchor Name is topofpage, you'll enter #topofpage when creating your link.

To link to an Anchor macro on another page:

  1. Copy the URL of the page whose anchor you want to link.

  2. Make note of the name of the anchor to which you want to link. The name is displayed on the anchor when editing the page.

  3. Go to the page where you want to add the link and edit the page.

  4. Highlight the text to be used as the link.

  5. Select the link tool .

  6. Paste the URL to the copied page in the link field followed by a # symbol and the anchor name.
    Example
    page name = Project notes

    Anchor name = notes from today
    Link = sitename.domain/wiki/Project+notes#notes-from-today

Pro tip — if you are adding a link to an anchor from a Gliffy diagram, you must use the entire URL, not just the pagename#anchorname portion.

Link to attachments

To link to a page’s attachment:

  1. Go to the published version of the page containing the attachment to which you want to link.

  2. Go to More ••• > Attachments.

  3. Right-click on the file name of the attachment, and select Copy Link Address.

  4. Go to and edit the page where you want to link to the attachment.

  5. Paste the URL in the link tool pop-up, and give it a more friendly name if desired.

To link to the latest version of an attachment on another page:

  1. Go to the published version of the page containing the attachment to which you want to link.

  2. Go to More > Attachments.

  3. Right-click on the file name of the attachment, and select Copy Link Address.

  4. Go to and edit the page where you want to link to the attachment.

  5. Paste the URL in the link tool pop-up, remove any text after the file extension in the URL, and give it a more friendly name if desired.

Create and link to an undefined placeholder page

Sometimes you want to link to a Confluence page that doesn't exist yet. To do this, you can add an undefined link and come back to it later. When you select on the link, Confluence will create a draft page with that title for you to then add content to and publish when you're ready.

Undefined placeholder links can't be added to templates.

  1. Type [Placeholder Page Name]().
    This follows the syntax as the keyboard shortcut for adding defined links[Link](http://a.com).

  2. Press Enter or Return to create the placeholder.

  3. Select Close to keep the page as a DRAFTor select Publish… or Update.

Using a keyboard shortcut is the only way to accomplish this right now. In the coming months, the ability to add undefined links will be added to the editor toolbar and slash command menu.

A link to an undefined page is shown in red. Until you actually publish this newly created page, anyone withcreatepermissions in that space can select on the link, while viewing or editing, and it will continue to create new draft pages.

View undefined pages in a space

TheUndefined page shows you all the undefined pages in your space.

To view a list of the undefined links in a space:

  1. Go to the space in Confluence Cloud.

  2. SelectSpace settingsfrom the sidebar.

  3. SelectUndefined from the Manage pages card.

The undefined page links have agreenbadge to remind you that these pageshaven't been published yet. Select an undefined page link to create a draft and add content to it.

Display options

Once you type in or paste a link when editing a Confluence page, you can choose how it appears after you publish.

To change the Smart Link display:

  1. Type in or paste a link, or use the /link command. You may also use Cmd + Kfor Mac or Ctrl + Z for Windows:

  2. Select the link.

  3. From the Smart Link toolbar, select your preferred display option:

Smart Links in Confluence | Confluence Cloud | Atlassian Support (5)

Inline view

Instead of a URL, inline view shows only the title of the link. This is useful when you want to insert multiple links in a table.

Smart Links in Confluence | Confluence Cloud | Atlassian Support (6)

Card view

Card view offers more context by showing metadata like project details and summary. When your readers hover over Smart Links displayed in card view, they can interact with link elements or preview the content. Select Open preview to view the link at near page-width without leaving the page.

Smart Links in Confluence | Confluence Cloud | Atlassian Support (7)

Embed view

Embed view allows you to view pages, boards, lists, timelines, or calendars in other products without having to leave the page. Watch a video from YouTube, read and edit documents, leave comments in your design files and more, all within your current page.

Smart Links in Confluence | Confluence Cloud | Atlassian Support (8)

Smart Links from Jira and other products

You may insert links from other products and convert them into Smart Links.

For example:

  • Display Jira issues in a list

  • Display your Assets data on a Confluence page

  • Share Jira dashboards in Confluence

Other products that use Smart Links:

Atlassian products:

Non-Atlassian products

  • Atlas

  • Atlassian Analytics

  • Bitbucket

  • Compass

  • Jira

  • Jira Roadmaps

  • Jira Align

  • Trello

  • Adobe XD

  • Asana

  • Azure Devops

  • Box

  • Dropbox

  • Figma

  • GitHub

  • GitLab

  • Gliffy

  • Google Drive

  • Invision

  • Microsoft OneDrive (personal only)

  • Miro

  • Mural

  • Salesforce

  • Slack

  • Stripe

  • YouTube

  • Zeplin

  • Zoom

Authentication for Smart Links

You must be logged in to non-Atlassian products that require authentication before you can display the Smart Link in your page. You’ll only need to do this once, and that product’s links will work across all of Atlassian Cloud.

For links to non-Atlassian product that requires access to view, readers need to be logged in for Smart Links to display in the correct view.

What data is sent and received when pasting a Smart Link?

Summarize Smart Links with AI

Save time by summarizing the content of a Smart Link with Atlassian Intelligence.

To use Atlassian Intelligence in Confluence, your organization admin needs to activate AI features from Atlassian Administration.

To summarize a Smart Link with AI:

  1. Navigate to the Confluence page or blog post containing a Smart Link.

  2. Hover over any Smart Link.

  3. Select Summarize with AI.

  4. Atlassian Intelligence will generate a summary.

A summary will not generate if there isn’t enough content to summarize or if summarizing the content might go against Atlassian’s Acceptable Use Policy.

For more on how Atlassian Intelligence works, its limitations, and our commitment to privacy, visit the Atlassian Trust Center.

Smart Link preferences

You can set your preferences on how links are displayed across Confluence, Atlas, Jira and soon for other Atlassian products. Your chosen link display option appears when you edit pages or comment on issues.

Go to link preferences from Confluence:

  1. Select your avatar from the top-right menu.

  2. Select Manage Account.

  3. Select the Link preferences tab at the top.

Go to link preferences from Jira:

  1. Select the settings cog [cog image] on the top-right menu.

  2. Under ‘Personal settings, select Atlassian account settings.

  3. From the left-side menu, select Link preferences.

Set your default display for new links

You can choose how to display links you create:

  1. From Link preferences, go to the Default display section.

  2. Choose your preferred display option from the dropdown.

Links created by other users will appear depending on the display option they choose.

Remember to refresh active editor sessions after you update your preferences.

Exceptions for specific domains

You can set different display options for links from specific domains:

  1. From Link preferences, go to the section labeled Exceptions for specific domains.

  2. Type or paste in a domain or URL.

  3. Choose your preferred display option from the dropdown.

  4. Select Submit.

  5. Add exceptions for other domains if needed.

Exceptions for subdomains

You may enter subdomains as your URL to set default display options for links from specific sections of a website.

For example, if you set a preference for links from google.com to display as a card, all subdomains will follow the same rule.

If you only set an exception for slides.google.com, the other Google domains display as the default setting or any custom preferences you may have set.

If a domain cannot be displayed as an embed, your link will default to inline.

Legacy editor

This section provides the details for adding links and anchors to your page using the legacy editor.

Internal links

Here's how to link to content from within Confluence

Link to a page

If it's a page in the same space:

  • From the toolbar, selectLink>Searchthen enter part of the page name. Select the page when it appears in the list.

  • From the toolbar, selectLink>Recently viewedand select a page from the list.

  • Type[and enter part of the page name, then select the page from the list.

  • Paste the URL of the page onto your page (Confluence will automatically create the link).

If it's a page in a different space:

  • From the toolbar, selectLink>Searchand from the space dropdown, either select the space the page lives in, orAll Spaces. Then enter part of the page name, and select the page when it appears in the list.

  • From the toolbar, selectLink>Advancedthen enter the space key followed by the page namespacekey:mypage.

  • Type[and enter part of the page name then select the page from the list.(You can hover over each suggestion to see which space the page is from).

Link to a blog post

  • From the toolbar, selectLink>Searchand enter part of the blog post name, then select the post when it appears in the list.

  • Type[and enter part of the blog post name then select the blog post from the list.

Link to an attachment

On this page:

  • From the toolbar, selectLink>Attachmentthen upload or select an attachment from the list.

  • Type[and enter part of the attachment file name then select the attachment from the list.

On another page:

  • From the toolbar, selectLink>Searchand enter part of the attachment name, then select it when it appears in the list. (You can hover over each suggestion to see which space the page is from).

  • Type[and enter part of the attachment file name then select the attachment from the list

Link to a website

  • From the toolbar, selectLink>Web Linkthen enter the website URL.

  • Type or paste the URL onto the page (Confluence will automatically create the link).

Link to an email address

  • From the toolbar, selectLink>Web Linkthen enter the email address.

  • Type or paste the email address onto the page (Confluence will automatically create a 'mailto:' link).

Link to a heading on a page

ChooseLink>Advancedthen enter the heading in one of the formats below. Heading text is case sensitive and must be entered without spaces.

  • For a heading on this page:#MyHeading.

  • For a heading on another page in this space:Page Name#MyHeading.

  • For a heading on another page in another space:spacekey:Page Name#MyHeading.

Be aware that these links will break if you edit the heading text. Consider using theTable of Contentsmacro or anAnchorinstead.

Link to a comment on a page

  • Go to the comment, right-click theDateat the bottom of the comment, copy the link, and paste it directly into your page.

  • Type[$then enter the Comment ID (12345in this example): [$12345]

Link to an anchor on a page

Use anchors to enable linking to specific locations on a page. These can be especially useful for allowing your readers to jumpto specific parts of a long document. Anchors are invisible to the reader when the page is displayed.

Link to an anchor
  • Anchor names, including the space key and page name, are case sensitive.

  • Enter page and anchor names with spaces when you link to them in the same Confluence site

  • If you're linking to an anchor on a different page that has special characters in its name, where the URL displays a page ID rather than a name, you should still enter the page name when linking to it

  1. Select some text or position your cursor where you want to insert the link

  2. From the toolbar, selectLinkin the toolbar or pressCtrl+K

  3. SelectAdvancedand enter the anchor name in theLinkfield, following the format below.

Anchor location

Link syntax for anchor

Examples

Same page

#anchorname

#bottom

#importantinformation

Page in same space

page name#anchor name

My page#bottom

My page#important information

Page in different space

spacekey:pagename#anchorname

CONFCLOUD:Mypage#bottom

CONFCLOUD:Mypage#importantinformation

4. Enter or modify theLinkText(this is the text that will appear on the page. If this field is left blank, the page name or URL will be used as the link text)

5. SelectSave

Link to an undefined page(a page that does not exist yet)

Sometimes you want to link to a Confluence page that doesn't exist yet. To do this, you can add an undefined link and come back to it later. When you select on the link, Confluence will create a draft page with that title for you to then add content to and publish when you're ready.

Create an undefined pagelink:
  1. From the toolbar, selectInsert>Linkor pressCtrl+Kon your keyboard.

  2. SelectAdvanced from the left navigation

  3. Enter the name of the page to be created in theLinkfield.

A link to an undefined page is shown in dark red. Until you actually publish this newly created page, anyone withcreatepermissions in that space can select on the link, while viewing or editing, and it will continue to create new draft pages.

View undefined pages in a space

TheUndefined Pagesview shows you all the undefined pages in your space.

To view a list of the undefined links in a space:

  1. SelectSpace settingsin the sidebar, then chooseContent tools

  2. SelectUndefined Pages.

The undefined page links have agreenbadge to remind you that these pageshaven't been published yet. Select on the link for an undefined page to create a draft and add content to it.

Link to a personal space or user profile

  • From the toolbar, selectLink>Searchthen enter the user's name and select their personal space overview or their profile from the list.

  • Type[then enter the user's name and select their personal space overview or their profile from the list.

Link to a Jira issue(where Confluence is connected to Jira)

  • Paste the Jira issue URL - Confluence will automatically create a Jira Issue macro.

Use a shortcut link

If you haveconfigured shortcut linkson your Confluence site, then you can link to an external site using a shortcut link that looks like this:CONF-17025@jira.

To add a shortcut link using the Insert Link dialog:

  1. From the toolbar, selectLink>Advancedand enter or paste the shortcut link into theLinkfield (shortcut links are case-insensitive)

  2. Modify or enter link text (this is the text that will appear on the page)

  3. SelectInsert

You can also type[and chooseInsert Web Link>Advanced to enter a shortcut link.

External links

Here's how to link toConfluence contentfrom other websites and in emails.

Link to a heading

Example

http://myconfluence.com/display/spacekey/pagename#pagename-headingtext

Link to a comment

Example

http://myconfluence.com/display/spacekey/pagename?focusedCommentId=commentid#comment-commentid

To find out the comment URL and comment ID:

  1. Go to the comment you wish to link to

  2. Select theDateat the bottom of the comment and examine the URL

The number aftercomment-is the Comment ID

Link to an anchor

Example

http://myconfluence.com/display/spacekey/pagename#pagename-anchorname

Some important details to keep in mind:

  • The page name is repeated in the URL, after the # sign. The second occurrence of the page name is concatenated into a single word, with all spaces removed.

  • There is a single dash (hyphen) between the concatenated page name and the anchor name.

  • The anchor name in the full URL is concatenated into a single word, with all spaces removed.

  • The anchor name iscase sensitive. You must use the same pattern of upper and lower case letters as you used when creating theAnchor.

Remove or modify a link

  1. Select the link text or image

  2. SelectUnlinkfrom the link properties toolbar to remove the link

  3. SelectEditfrom the link properties toolbar to modify the link, make your changes, and chooseSave

Smart Links in Confluence | Confluence Cloud | Atlassian Support (2024)
Top Articles
Latest Posts
Article information

Author: Nicola Considine CPA

Last Updated:

Views: 6679

Rating: 4.9 / 5 (69 voted)

Reviews: 84% of readers found this page helpful

Author information

Name: Nicola Considine CPA

Birthday: 1993-02-26

Address: 3809 Clinton Inlet, East Aleisha, UT 46318-2392

Phone: +2681424145499

Job: Government Technician

Hobby: Calligraphy, Lego building, Worldbuilding, Shooting, Bird watching, Shopping, Cooking

Introduction: My name is Nicola Considine CPA, I am a determined, witty, powerful, brainy, open, smiling, proud person who loves writing and wants to share my knowledge and understanding with you.