Problem

When embedding a Google Document (such as Docs, Sheets, or Slides) using Smart Links in Confluence Cloud, the preview always renders from the very beginning of the file. Even if the URL provided includes a specific fragment or target (e.g., #heading=h.xxxx for a Doc or #gid=xxxx for a Sheet), the Smart Link resolver ignores these parameters and displays the top of the document. This forces users to manually scroll or search for the relevant content, defeating the purpose of deep-linking.

Suggested Solution

Enhance the Smart Link resolver to recognize and respect URL fragments and parameters for Google Drive links. When a user pastes a link that points to a specific section, header, or tab, the embedded Smart Link preview should automatically navigate to and display that specific location within the document.

Why This Is Important

Users often need to provide immediate context by displaying a specific part of a large document or a specific tab of a spreadsheet directly on a Confluence page. Without this capability, the integration is less efficient, as readers must spend extra time navigating the embedded file to find the information being referenced. Supporting deep-links would significantly improve the user experience and the utility of Smart Links as a replacement for older embedding methods.

Workaround

Currently, the only ways to achieve this behavior are:

Iframe Macro: Using the Iframe macro with the same Google Drive URL correctly respects the fragments and loads the specific section.

HTML Macro: (Where available/enabled) This can also be used to embed the document with the specific target parameters.