How to Fix Double-Bracket Page Links Not Loading in Modern SharePoint
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.

- 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.
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.
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.
Open your modern SharePoint page in Edit mode and highlight the text you want to convert into a link.
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.
Paste the destination SharePoint page URL into the address field, ensure the display text is correct, and click 'Save' or 'Apply'.

Force Refresh and Save the Page Draft
If you have already created pages using double-bracket links, forcing a manual page refresh will make the missing assets appear.
Manually Correct the Wiki Link Syntax
If you are interacting with legacy links that contain incorrect wikiTitle parameters, manually updating the link syntax string can resolve navigation errors.
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. Download the software: Visit the official WPS website to download the free WPS Office installer.
- 2. Install the suite: Run the installer and follow the simple on-screen instructions to set up the software.
- 3. Open your files: Launch WPS Office and directly open your existing Office documents to start editing immediately.

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.




