SharePoint Document Issues

How to Fix Double-Bracket Page Links Not Loading in Modern SharePoint

Bushra ParveenBushra Parveen Nov 4, 2026 869 views

Question details

The user needs a solution for an issue where modern SharePoint pages created or linked via double brackets do not load assets properly until refreshed.

How to Fix Double-Bracket Page Links Not Loading in Modern SharePoint
Product
Microsoft SharePoint
Device & OS
not provided
Scenario
Creating new pages or navigating to existing ones using the double-bracket [[ ]] linking method within a regular SharePoint page library.
Observed behavior
Page assets fail to load or display properly until the user saves the draft and refreshes the page. Additionally, links may generate incorrect names or append a wikiTitle parameter.
Before you start

Verify whether your SharePoint site is utilizing a regular Site Pages library or a legacy Wiki library, as modern page features handle link routing differently.

Solution 1Recommended

Use the Ctrl+K Shortcut to Create Page Links

Since the double-bracket syntax is currently bugged in modern page libraries, using the standard link insertion shortcut is the most reliable method.

The double-bracket [[ ]] link creation is a legacy feature from Wiki libraries. In modern SharePoint pages, this method can break the rendering of page assets. Utilizing the rich text editor's native link functionality bypasses this glitch.

1
Highlight the anchor text

Open your modern SharePoint page in Edit mode and highlight the text you want to convert into a link.

2
Trigger the link tool

Press Ctrl + K (or Cmd + K on a Mac) on your keyboard, or click the 'Link' icon in the text formatting toolbar above the web part.

3
Insert the URL

Paste the destination SharePoint page URL into the address field, ensure the display text is correct, and click 'Save' or 'Apply'.

Use the Ctrl+K Shortcut to Create Page Links
Avoid Link Bugs: Using the Ctrl+K method ensures that the modern SharePoint page routing triggers correctly, preventing the blank asset loading bug.
Free Microsoft Office alternative

Enhance Your Document Workflow with WPS Office

While SharePoint is excellent for managing site architecture and storing files, editing documents effectively requires a robust office suite. If you are experiencing limitations or bugs in Microsoft environments, WPS Office serves as a highly compatible, lightweight, and free alternative to Microsoft Office.

  1. 1. Download the software: Visit the official WPS website to download the free WPS Office installer.
  2. 2. Install the suite: Run the installer and follow the simple on-screen instructions to set up the software.
  3. 3. Open your files: Launch WPS Office and directly open your existing Office documents to start editing immediately.
Fully compatible with Microsoft Office formats like .docx, .xlsx, and .pptx.Lightweight installation ensures fast performance even on older hardware.All-in-one suite design lets you manage Word, Excel, PowerPoint, and PDFs in a single window.Familiar tabbed user interface makes the transition smooth and intuitive.
microsoft office alternative - wps office

Frequently Asked Questions

Why do double-bracket links cause missing assets in Modern SharePoint?

Double-bracket linking is a legacy feature originally designed for Classic SharePoint Wiki pages. When used in Modern SharePoint regular page libraries, it conflicts with the modern routing and rendering engine, causing the page to stall before loading all scripts and web part assets.

Will Microsoft patch the double-bracket link bug?

The issue has been reported by multiple administrators through the SharePoint Feedback Community (formerly UserVoice). However, because Modern SharePoint prioritizes standard web linking methods over legacy Wiki syntax, there is currently no confirmed timeline for a bug fix.

How can I quickly create a new linked page without using brackets?

Instead of typing [[NewPageName]] to auto-generate a page, navigate to your Site Pages library or homepage, click the 'New' button, select 'Page', and publish it. Then, return to your original page and use the Ctrl+K shortcut to link directly to the newly created page URL.