Preview Gitlab files on Confluence pages and Jira tickets

Have you tried out Smart Links yet? Smart Links offer you different ways to display a link above and beyond a traditional hyperlink or URL. Try Smart Links for your favorite work tools, like Dropbox, Asana, Google Drive, and more. They are available on both Confluence and Jira.

Preview your Gitlab files directly on pages with Smart Links

To add a Gitlab Smart Link, simply paste the URL link on a Confluence page or type “/link” to insert. Once pasted, you can view the file as a small “inline” link which quickly lets you know the file’s title and format – in this case a Gitlab file.

Smart Link Inline Gitlab.png

You can change toggle your view to a more impactful “card” preview where you can see more information about that file like the status, language, and more.

Smart Link Card Gitlab.png

View your latest repository side-by-side to your technical documentation, all on one page!

More Smart Links are coming so stay tuned!


Fernando Maia November 24, 2020

How can I configure it for a self-hosted GitLab instance?

Like Dmytro Makhno likes this
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
July 27, 2021

Hello all,

Is someone has an idea about the way to we have to configure GitLab for enabling the Smart link in Confluence ?



Like # people like this
Michael Suchacz
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
February 22, 2023

Hey @Jonno Katahanas 

does this feature need additional configuration? We use, but we only see "SSO login" as a preview for GitLab links.

Like Zack Howard likes this
Sue Rocha_Mibex Software_ March 29, 2023

Hello all, 

If you are looking for a way to show the complete file from GitLab private or public repos within Confluence as an additional feature for those interested to inline documentation, you may find Include GitLab for Confluence Cloud useful.

You can simply copy the URL of the GitLab file and paste it into the Confluence page.

In the following example we use this GitLab URL of a .md file:

Then paste the URL in the Confluence file as shown in the video and the macro will automatically be applied to embed the file.

Include gitlab - copy file url (background) (2).gif

I hope this is helpful.

Best regards,
Sue from Mibex Software

Zack Howard October 5, 2023

This feature doesn't seem to work. Has it been disabled?


Log in or Sign up to comment
AUG Leaders

Atlassian Community Events