SharePoint Document Issues

Fix Visio Online Hyperlinks After Uploading to SharePoint

Maira MehtabMaira Mehtab Nov 14, 2026 868 views

Question details

The user needs to identify why hyperlinks that work in desktop Visio fail when the drawing is opened online from SharePoint.

Fix Visio Online Hyperlinks After Uploading to SharePoint
Product
Microsoft Visio Online and SharePoint
Device & OS
not provided
Scenario
A Visio drawing containing hyperlinks is uploaded to a SharePoint document library and opened online.
Observed behavior
A hyperlink that works in desktop Visio may fail online, with SharePoint reporting that the linked object does not belong to a list. Percent signs in the link may be encoded as %25.
Before you start

Confirm that you can open both the drawing and its intended target in SharePoint. Note the desktop Visio version and copy the target URL directly from the browser for comparison.

Solution 1Recommended

Test a SharePoint library hyperlink in desktop Visio and online

Use a direct library link to check whether the failure is specific to the original hyperlink or occurs after the drawing is uploaded.

1
Copy the library address

Open the target SharePoint site and document library in your browser, then copy its URL from the address bar.

2
Change the Visio hyperlink

Open the drawing in desktop Visio, select the linked shape, and choose Insert > Hyperlink or press Ctrl+K. Replace the address with the copied library URL and check that the Sub-address field is appropriate.

3
Save and upload the drawing

Save the edited drawing, then open the SharePoint document library and use Upload > Files to upload it. If prompted, follow the option to replace the existing file or upload a separately named test copy.

4
Test the link online

Open the uploaded drawing from SharePoint in Visio for the web and select the hyperlink. Compare the result with the same link in desktop Visio.

Test a SharePoint library hyperlink in desktop Visio and online
Interpreting the test: If the library link works online, compare it with the original target address and its encoding. If it also fails, test the drawing with another desktop Visio version.
Free Microsoft Office alternative

Use WPS Office for Everyday Office Documents

WPS Office is a free, lightweight alternative for working with common Office documents in a familiar interface. It can help you move routine document work between Office-compatible formats, although it does not fix Visio or SharePoint hyperlink behavior.

Work with hyperlinks in everyday text documents, spreadsheets, and presentationsCompatible with Microsoft Word, Excel, and PowerPoint formats, including DOCX, XLSX, and PPTXFamiliar editing tools make it easier to move common Office workflowsFree and lightweight for everyday document work
microsoft office alternative - wps office

Frequently Asked Questions

Why does %25 appear in my Visio hyperlink?

%25 is the URL encoding for a percent sign. It can be legitimate, but a sequence such as %2520 may indicate that an existing %20 was encoded again. Compare the hyperlink address in Insert > Hyperlink with the working target URL before changing it.

How can I tell whether the original link is the problem?

In desktop Visio, change a test hyperlink to the URL of the SharePoint document library, save the drawing, and upload it. Open the drawing from SharePoint and test the link online. If that works, compare the original address and its encoding with the working link.

Could my desktop Visio version affect the hyperlink?

It may be relevant. If another version is available, set the same hyperlink in a test copy, save and upload it to the same SharePoint library, then compare how both drawings behave online.

Do matching links in the drawing's XML rule out an encoding issue?

Not necessarily. Similar stored links do not show how each link is processed when opened online. Compare the saved hyperlink fields with the working SharePoint URL and test the uploaded drawing in Visio for the web.