Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

graph:smartLink — Is the "Embed" view mode available for third-party resolvers?

Jorge Zapata
April 29, 2026

I'm building a Forge app using the `graph:smartLink` module to resolve internal service URLs into Smart Link cards. The resolver works correctly — Card and Inline views show the expected title and description — but the **Embed** view option never appears in the Smart Link dropdown, even though it does appear for native Atlassian content like Confluence pages.

I've tried returning the entity using both `atlassian:document` and `atlassian:video` (which has an explicit `embedUrl` field in the Teamwork Graph schema), but neither causes the Embed option to surface in the UI.

Looking at the Atlaskit Smart Card documentation ([embed-card docs](https://atlaskit.atlassian.com/packages/linking-platform/smart-card/docs/embed-card)), the Embed view appears to be driven by a `data.preview.href` field in the resolver response — but this belongs to the old JSON-LD / Activity Streams protocol, which is not part of the Teamwork Graph entity format used by `graph:smartLink`.

So my questions are: is there any way to provide an embed URL through the `graph:smartLink` entity response that causes the Embed view to appear? Does `atlassian:video.embedUrl` drive the Smart Link Embed view, or is it only used for internal Teamwork Graph indexing? And is the Embed view intentionally restricted to first-party Atlassian content, or is this a gap in the current module that is planned to be addressed?

0 answers

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PRODUCT PLAN
STANDARD
PERMISSIONS LEVEL
Product Admin Site Admin
TAGS
AUG Leaders

Atlassian Community Events