Showing results for 
Search instead for 
Did you mean: 
Sign up Log in
It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Smart Links, a richer way to hyperlink


Great tip @Vitalii Saienko , and I see the link text can be edited further from there, if desired. Thank you! 

Like Vitalii Saienko likes this

At a glance it seems like Smart Link Embeds are using the source's OOB embed functionality, but not implementing a custom view of the content.  Am I correct in that perception?

James Dellow Community Leader Aug 19, 2020

Do the smart links to Confluence pages work with the Excerpt macro at all?

Hi, Is this feature available for Confluence yet ? Is this only for confluence cloud ?

Like # people like this

How do you turn this off?


If I have a paragraph of text with 4-5 links after it, I now have no way of copying and pasting this information elsewhere.


This insidious 'lock-in' is awful.  

Like # people like this

Thanks for this introduction.

For more detail on how Smart Links works, check out our support documentation

A link to the support documentation (or any page about versioning, pricing, etc.) would have been welcome :-)

Where can I find about versioning and pricing?

Does this include documentation as links too?

It should be noted that (according to smart links only work for cloud-hosted GitLab instances, not for on-premises instances. Which, unfortunately, renders this type of smart links more or less useless, as self-hosting is GitLab’s USP.
Apart from that, sounds like a nice addition, although for the moment, without on-premises-GitLab-support, we won’t have any benefits from it.

And a remark regarding the posting’s last sentence: when referring to the documentation, wouldn’t it be useful to just link to the documentation?

Like Abbas Dar likes this

This is clunky; it's a pain to have to press `ctrl+z` to undo. Is there a way to disable this behavior by default? I can appreciate that this can be useful at times, but it's slow and inefficient.

Like # people like this

@Jonno Katahanas  Where are the settings for these? Our links randomly started turning into cards, we need them all to be URLs. How do we turn this off pls

Like # people like this

Please disable this for links that are not in your list, we use external links to our products and instead of see the link we now get this "Smart Link" that basically takes away any context link has. I have to continuously switch them to normal links.

Like # people like this

1. Why was this "feature" introduced for unknown external links (ones not in your list)?

2. What problem is it solving or how it is helping people?

Like # people like this

Hi Atlassian team, I'm with @Tina Hutchinson on this one.

Is there a way I can change the default behaviour for smart links?

Currently, and especially in Jira, the default behaviour seems to be "display inline".

And I find myself so much of the time wanting the "display URL".

So in my case, this feature is causing me more manual labour than if it wasn't "smart".

I'd prefer that default behaviour is in the priority order as per the dropdown:

  1. URL
  2. inline
  3. card

Please let me know.

It's a small, but daily nuisance.

Like # people like this

It automatically turns into Inline view, but I want the URLs to display as the way it is automatically, instead of changing every single link from inline to display. How can I do this? 

Like # people like this

While Smart Links are helpful in some situations, we usually don't want them because a) many pages we are linking to do not have really helpful page titles and b) fetching the title takes time and slows down the Confluence experience.

So PLEASE make this feature optional! We have to revert each and every link we paste into Confluence manually (CTRL-Z). Give us a preference setting in the user profile how to treat links by default.

Like # people like this

How do we turn OFF Smart Links? Our JIRA Service Desk instance does not have formatting and outgoing messages with any URLs are breaking and unusable to customers.

A basic URL, such as, now appears like this with Smart Link: [||smart-link] 

Like Bill_P likes this

Is there a User Agent we can block on our servers to disable this feature from fetching?

In testing if you add a dead link it does not do this "Smart linking" so i theory If i block your requests then it will not auto update the link. This only help for servers I have control of but at least it 80% of the links I do not want updated.

Is there a way to see more details on Jira ticket cards in Confluence? At the moment there seems to be a lot of wasted space, but it would be great to see descriptions, attachments, comments, priorities, etc. 

Like Devon Cornes likes this

Why smartlink is not working here? I paste the Xd link but is not show the options to display the preview

Actually I find it to be the worst feature ever. I would really like the ability to turn this off on my cloud environment. Pressing cntrl/cmd-z is fine for a single link, but if you are pasting in a table full of URLs it's not really an option.

Like # people like this

Smart Links is like Spam: it should be opt-in, instead of opt-out-for-every-damn-link.

It makes it impossible to see different URLs for same/similar sites/pages -- and for web developers, that makes it worse than bad.

At least disable this behavior for links outside the Atlassian ecosystem. Please.

Hi @Jonno Katahanas,

I notice that smart links don't render for anonymous users on my Confluence instance.

So when adding a YouTube video embed, you'd end up with something that at first glance looks like it works, but if you then logout and have another look at the page, you get the following:

Screenshot 2021-07-29 at 13.40.01.png

As smart links have overridden the widget macro behaviour for auto-converting URLs, this is a step backwards in product functionality. Something which was once ridiculously easy now requires cognitive effort.

You now need to remember the use cases for which smart links work and then behave accordingly.

Our Gitlab is behind SSO. Even if I authenticate and refresh the Confluence tab, the Smartlink doesn't display the Gitlab content. Any suggestions on how to get this to work?

As someone who writes a lot of detailed requirements and technical planning documents that contain URLs that I want to simply stay unchanged, the way I type them in, I absolutely detest this compulsory feature.

Please offer an option to opt-out of these smart links - they're driving me crazy. When we type / paste a URL into confluence documentation, we *want* it to be clear, not obfuscated behind the target web title which is often meaningless.

It's fine for Confluence internal page links; it's terrible for external site links.

Having to undo, and reformat EVERY SINGLE LINK in an article wastes time, not saves it.

Like Carsten Blüm likes this


Log in or Sign up to comment
Community showcase
Published in Confluence Cloud

🏠 Say hello to the new Confluence Home!

Hi Atlassian Community, My name is DJ Chung, and I’m a Product Manager on the Confluence Cloud team. Today, I’m excited to share a new and improved version of Home. The new Home helps you ...

43,633 views 33 135
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you