Windows Integration Errors

Fix the Microsoft Word URI Scheme Error When Opening a Jira Document Link

Muhammad TalhaMuhammad Talha Nov 13, 2026 869 views

Question details

The user needs a Word document link in Jira to open in desktop Microsoft Word instead of Word Online without producing an Office command error.

Fix the Microsoft Word URI Scheme Error When Opening a Jira Document Link
Product
Microsoft Word, Jira, and OneDrive for Business
Device & OS
not provided
Scenario
A document hosted online is linked from Jira, and the ms-word:ofe|u| prefix is added to request opening it in desktop Word.
Observed behavior
The HTTPS link opens normally in Word Online, but the prefixed link produces an Office command error. A long sharing URL or unsupported characters may be contributing factors.
Before you start

Confirm that desktop Microsoft Word is installed and that you can access the document with the appropriate Microsoft account. Keep the original HTTPS link available so you can compare browser access with the prefixed link.

Solution 1Recommended

Use a direct HTTPS document URL with the Word URI prefix

Use this approach when the current Jira link is a long OneDrive sharing link or opens a sharing page rather than pointing directly to the document.

The ms-word:ofe|u| prefix requests that desktop Word open a document for editing. It needs a document URL that Word can resolve; a link that works in Word Online is not necessarily suitable for this command.

1
Locate the document URL

Open the original Jira link in your browser and locate the file in OneDrive for Business or its SharePoint document library. Use the file's Details pane or ask the library owner for its direct HTTPS document URL rather than reusing a long sharing or viewer link.

2
Verify browser access

Paste the direct HTTPS URL into your browser's address bar and open it. Confirm that it reaches the intended document and that you have access; resolve any sign-in or permission issue before adding the Word prefix.

3
Check the path and filename

Compare the URL with the document's actual location and filename. Copy the URL without surrounding spaces or punctuation, and preserve any URL-encoded characters. Do not remove query parameters from a sharing link and assume the result is a direct document URL.

4
Build and test the Word link

Prepend ms-word:ofe|u| directly to the verified HTTPS URL, with no spaces. The structure should be ms-word:ofe|u|https://your-tenant.sharepoint.com/sites/your-site/Shared%20Documents/file.docx. Test the resulting link and approve the browser's prompt to open Microsoft Word if one appears.

5
Update the Jira link

Edit the document hyperlink in the Jira issue and replace its target with the tested Word URI. Save the issue and click the link again. If Jira rejects the custom URI, retain the HTTPS link and use the document's Open in desktop app option instead.

Use a direct HTTPS document URL with the Word URI prefix
A Word URI does not grant document access: The prefix launches desktop Word but does not bypass OneDrive or SharePoint permissions. The account used in Word must be authorized to open the document.
Free Microsoft Office alternative

Open Downloaded Jira Word Documents with WPS Writer

WPS Office is a free, lightweight alternative with a familiar interface and Microsoft Word format compatibility for an easy transition. It does not repair Microsoft's ms-word URI handler, but WPS Writer can open an authorized local copy downloaded from OneDrive or SharePoint.

Open and edit Microsoft Word .doc and .docx files.Work with a downloaded Jira-linked document without relying on the ms-word URI scheme.Use familiar document-editing tools in a lightweight Office suite.Move existing Word documents into WPS Writer without manually re-creating their content.
microsoft office alternative - wps office

Frequently Asked Questions

What does ms-word:ofe|u| do?

It is an Office URI command that requests opening a document for editing in desktop Microsoft Word. Place it immediately before the document's HTTPS URL. Desktop Word must be installed, and the document must be accessible to your account.

Why does the link work in Word Online but fail in desktop Word?

The browser may be resolving a OneDrive sharing or viewer link that the Office URI handler cannot use as a document address. Test a direct HTTPS document URL, and use Word Online's Open in Desktop App or Open in Word command to compare the behavior.

Does shortening a OneDrive sharing link fix the Office command error?

Not necessarily. A shortened link still redirects to the original destination and may not identify the document directly. Obtain the direct document URL from the file's library or its owner instead of shortening the sharing link or deleting its parameters.

What should I check if the Word URI works outside Jira?

Edit the Jira hyperlink and compare its saved target with the working URI. Jira or an organizational security policy may reject or alter custom schemes. Ask your Jira administrator to check supported schemes, or keep the HTTPS link and open the desktop app from Word Online.

Can WPS Office fix the ms-word protocol error?

WPS Office does not repair Microsoft's ms-word protocol handler. As an alternative, open the HTTPS link, download the document if permitted, and use WPS Writer > Open to select the local .doc or .docx file. A downloaded copy is separate from the cloud document unless you upload it again.