Atlassian Smart Links are now available for MURAL in Confluence, Jira, and Trello. Smart Links reveal important content about a link's destination from within a Confluence page, Jira issue, or Trello card (without leaving that application).
Using Smart Links
The beauty of this functionality is that it's easy and intuitive to use.
To create a Smart Link in a Confluence page, Jira issue, or Trello card:
Get a link to your mural. Do one of the following:
Copy your mural's URL from the address bar, or
Click the Share button to generate a link (for members, visitors, or embeds).
Paste your mural's URL in a Confluence page, Jira issue, or Trello card.
And, that's it! The pasted link automatically switches to the default Smart Link view (inline view).
To change the Smart Link view:
Click the Smart Link to open the floating toolbar.
Select the view you want from the Display drop-down.
Note: To choose an embedded display, you must enable embeds for the company and the mural.
Different views for Smart Links
With Smart Links, you can have up to 3 different views for a link:
Inline view: A stylish link that includes the logo.
Card view: A card with the logo, a preview image, and some additional information.
Embedded View: A view-only embedded version of the mural itself.
The inline view is the default view, and you can easily change it to a card view. To change the view to view-only embed, you need to enable the embed murals capability. (We cover this more, below.)
The Smart Links inline view shows a logo from the source of that link as well as the title of the content. Simply copy and paste the mural URL directly onto the page, and it automatically converts to an inline link.
The Smart Links card view shows you a small preview of the content, plus additional information about it. To switch a Smart Link from the default inline view to a card view, just use the view switcher in the floating toolbar below the Smart Link.
Coming Soon: Smart Link Embeds
Embedding a view-only version of your mural directly into Confluence, Jira, or Trello means you'll never have to break the flow of work or leave the page you're on. To switch a Smart Link from the default inline view to a card view, just use the view switcher in the floating toolbar below the Smart Link.
To change the Smart Link view to view-only embed, you need to enable the embedding murals capability. In the Company Dashboard, enable the option for view-only murals to embed into an Atlassian product.
If view-only embedding is turned off at the Company-level in MURAL, a member who tries to embed a mural with Smart Links will get an error message. The message will prompt them to turn on embedding for the company.
Enable embedding in MURAL
The steps to enable embedding in MURAL differ depending on the type of MURAL account you have.
Enterprise customers enable embedding at the Company level. Business or Team MURAL customers enable embedding at the Workspace level.
Enable embedding at the Company level
For Enterprise customers, here’s how to enable embedding at the company level:
Navigate to your Company dashboard.
Click the General tab on the left sidebar menu.
Click the Allow company members to embed murals checkbox.
The setting defaults to the In specific workspaces option with Allow members to embed murals selected. You can also select Do not allow company member to embed murals. Either way, Workspace admins have the ability to change this for each Workspace.
Note: If you prefer, you can allow embedding in all your company’s workspaces by clicking the Enforced for all workspaces option.
Enable embedding at the Workspace level
To enable embedding at the workspace level:
Click the Workspaces tab in the left sidebar menu.
Click Allow embedding of murals created in this workspace.
Frequently Asked Questions
How do viewing permissions work for embedded murals?
Easy! Anyone using the application where the Smart Link exists can see the view-only embed of a mural (as long as mural embedding is enabled). If a user clicks through from the Smart Link to MURAL, the original permissions of the mural still apply.
What should I do if I see "Embedding is disabled" when I try to embed a mural?
If mural embedding is turned off at the Company level or Workspace level in MURAL, a member who tries to embed a mural with Smart Links will get an error message that looks like this:
To turn on embedding from this error message:
Click the Embed tab.
Click the Enable Embedding button. The message will prompt them to turn on embedding for the company.
Once enabled, you’ll see an Embed link URL.
Copy the link and paste it into Confluence, Jira, or Trello to embed your mural.