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


We've been happily embedding YouTube videos in our documentation, not realising that they don't render at all for anonymous users, instead just showing a rendering error, like so:

Screenshot 2021-07-29 at 13.40.01.png

As smart links actually break the previously existing useful Confluence editor behaviour, it means that you have to unlearn your existing ways of working.

We've actually gone to the extremes of writing our own app to override the smart links behaviour for YouTube so that there is no additional cognitive effort to unlearn this.

It's available for free on Atlassian Marketplace - "YouTube in Confluence" now.



we need this for Confluence Datacenter as we refrain from going cloud

Hi @Jonno Katahanas could you provide the link to where the articles says "For more detail on how Smart Links works, check out our support documentation. Let us know what you think below!"

Links to our Sharepoint ( do not give Smart Links automatically but give a "click to preview" message next to the link and then on doing that, a dialogue/popover  box says wants a confluence admin to approve the link.

I'd like to give our new admin instructions on what exactly he needs to do.


@Jonno Katahanas sounds great, but unfortunately not working for me with Azure DevOps

Like sachin likes this

@Jonno Katahanasyou have mentioned: we are hoping we'll have something for you by early 2021 I cannot find that in Forge doc, any update about this?

Like # people like this

How do you get Smart Link embeds to work with Sharepoint/Word/Visio docs?

Like sachin likes this
sachin I'm New Here Oct 06, 2021

Is anybody even listening ?


Can someone please confirm that this is a CLOUD-ONLY feature? It seems implied at the top but someone else asked already and it was never answered. I've not been able to confirm it elsewhere...


Like # people like this

Hi @Chris Purser 

Yes, Smart Links is a Cloud-only feature.

Like Chris Purser likes this

Please offer us the option to turn off this feature. I understand its benefits but sometimes we just want to write some domains in a list without having to undo after each one. I think we should have the option to choose.



Like # people like this
James Dellow Community Leader Oct 15, 2021

@Marian-Ciprian Fudulache it might be easier on those occasions to use a (free) add-on like for those occasions 

That way, add the macro, then enter your links in Markdown format -e.g:

* [duckduckgo](
* [News Board](
* []([Duck Duck Go](

  Gives you:

pageshot of 'Testing sharing - James Dellow - Confluence' @ 2021-10-16-1134'42.png

Hi everyone, thanks for your interest and feedback on this feature. To answer Sachin and anyone else that might be thinking this, yes - we are listening! We will do our best to check in more regularly moving forward, and to respond to new questions or requests, starting with below: 

@James Dellow:

Yes, all Smart Link views of Confluence pages work with the Excerpt macro.

@Ciprian Haldan , @Claus Westerkamp : 

This is a cloud-only feature. There are currently no plans to provide Smart Link capabilities in products that are not cloud.

In Data Center, we have different ways of displaying specific links: page links will resolve to the page title, Jira links will show the Jira issue macro summary view, etc. 

In Data Center you can also make use of the Widget Connector Macro to bridge the gap between Confluence and the other sites and services your team uses to get work done. We support content from a number of different sites, including

  • YouTube

  • Vimeo

  • Twitter

  • Google Docs, Sheets, and Slides

  • Figma

You can read more about the Widget Connector Macro here: Widget Connector Macro | Confluence Data Center and Server 7.14 | Atlassian Documentation

@Nicolas Casel : 

Apologies – we’ve updated our original post with the link to our support documentation, and have also included it here:

Full Smart Link functionality is available in all of our cloud products – from our free versions upwards.

@Elissa : 

Thanks for the feedback and suggestions. We’re currently working on ways to include more information to make Jira Smart Link cards (as well as many others) more useful.

For news on the latest features being released in our cloud products, check out our blog.

@Wagner Carvalho : 

Sorry to hear your XD links aren’t working. To help us look into the problem for you, can we ask a couple of questions:

  1. Are you using a server or cloud product? If you’re using a server product, Smart Links won’t work. This is a cloud-only feature.
  2. What XD links are you trying to share? We currently support Smart Links for Files & Artboards only.

If you are using a cloud product and you are trying to insert a File or Artboard, we’d love to investigate further (if this issue is still happening). Can you please send through more details to our PM James Birney if above does not resolve the issue for you:

@Ken Mawbey : 

At the moment we only support Azure DevOps Work Items as Smart Links in our cloud products.

You can submit a ticket to if there are other DevOps types of links you would like to see supported as Smart Links in the future.

@David at David Simpson Apps :

We're investigating the issue of public links in public pages not showing for anonymous users and hope to have an update soon. 

Jim, Patrick, Vlad, Bill, Martin, Masato, Vinko, Andrew, Yuna, Chris, Lane and anyone else that has asked about turning off or opting out of Smart Links - we have heard you and are working on a solution currently. We will update here as soon as we can regarding that. 

Any questions that haven't been answered yet we do plan to address as soon as we can.  

Like Brittany Sudlow likes this

How do I disable this from happening? I don't always want to use Smart Links. In fact, 90% of the time, I go back to modify and display the full link.

How do I turn this off in Jira comments? This is destroying our workflow.

This is irritating, confusing, and always in the way, stop it!

If I want to insert something smart I want a macro.

If I insert an URL I expect it stay an URL, be displayed as URL, not eat up half my screen, and to open the link in a new tab if I middle-click it.

syisunny I'm New Here Jan 06, 2022

Hi @Jonno Katahanas ,

Is there any plan to put it into a datacenter version ? or make it available as a plugin on market place for datacenter versions ?

We are using a 7.4 in my company which does not support this smart link.

Or do you have other solutions to display a private gitlab file and pipeline in a confluence page with gitlab authentication?

Thank you for your help!

Best regards,


@Magda Bytnerowicz your post is ignoring the mountain of requests to turn this off. It's a security nightmare and never anything but obstructive to developers.

I like the Smart Link cards, but it seems one cannot format the content of the card. For some reason Confluence adds the Azure DevOps `Area Path` to the card title and that is just way too much clutter.  

If you want to bulk change links defaulted to Inline to show full URL then try the app we built for Confluence. Bulk change links to URL (vice versa). Easy Link Editor for Confluence.

We are looking to do something similar for Jira. Feedback appreciated.

I read your comment

@brosenek @Matthew Adair @Charles Le @Marian-Ciprian Fudulache @Lane Cipriani @Andrew Boyd @Chris Shenton @Mikel King @Misato T @Yuna Kim @Vinko Grgic @Bill_P @Patrick Nelson @David at David Simpson Apps @Tina Hutchinson @Martin Sauter 

if your team uses Confluence the app could help manager links even if I this doesn't deal with the issue of changing the default link type.


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,634 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