Share via

Math equations inside Content Controls become non-editable in Word Online after DOCX generation and SharePoint upload

Rohan Chourasia 0 Reputation points
2026-05-11T12:07:33.4033333+00:00

We are generating DOCX files programmatically (OOXML-based) where math equations (OMML) are placed inside Word Content Controls (SDTs).

In Word Desktop and in manually created Word documents, the equations inside Content Controls remain fully editable.

However, after uploading the generated DOCX to SharePoint and opening it in Word Online, the following issue occurs:

  • The paragraph containing the math equation becomes non-editable.
  • The equation inside the Content Control also becomes non-editable.
  • This only happens for programmatically generated documents, not for manually authored ones.
  • Tested on both Windows and MacOS as well

We have already tried:

  • Adding w:richText to SDTs
  • Preserving paragraph SDTs around math
  • Avoiding sanitizer removal of SDTs
  • Flattening nested SDTs
  • Aligning generated XML with Word-authored structure

Despite these changes, Word Online still renders the math-containing Content Control as read-only.

Question: Is this a known limitation in Word Online regarding OMML math inside Content Controls, or is there a required OOXML structure / property that enables editability in Word Online for such cases?

Microsoft 365 and Office | Word | For business | MacOS
0 comments No comments

2 answers

Sort by: Most helpful
  1. Jayden-P 21,315 Reputation points Microsoft External Staff Moderator
    2026-05-11T13:32:36.5733333+00:00

    Hi Rohan Chourasia

    After doing some testing, I do see the same behavior as yours. However, I have not found any official document stated this is a known limitation in Word Online.

    Word Online is designed for basic editing; more advanced features require desktop Word. The web editor supports equations and content controls individually but does not fully support editing complex OOXML combinations such as equations embedded inside content controls. These structures may render correctly but are treated as non-editable.

    Here are some suggestion you can try:

    • Put equation outside SDT

    <w:sdt> -> text only

    <m:oMath> -> outside

    • Use SDT as label / placeholder only:

    <w:sdt> -> "Enter equation below:"

    <w:p>   -> equation

    I hope this information helps.


    If the answer is helpful, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment". 

    Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.

    Was this answer helpful?


  2. Q&A Assist
    2026-05-11T12:07:49.47+00:00
    AI generated content. This question contains an answer created with AI from Q&A Assist. Learn more

    Word for the web has known limitations where certain objects become non-editable, especially when their structure comes from programmatic generation rather than from the desktop authoring experience. In particular, Word for the web can treat some complex constructs as read-only, including:

    • Content created or modified in ways that are not fully supported by Word for the web’s editing model.
    • Elements that are valid OOXML but whose combination (for example, structured document tags wrapping complex content) is only partially supported in the web editor.

    The available documentation explicitly calls out similar behavior for other elements (for example, non-editable links in Word for the web that must be deleted and recreated to become editable), and more generally notes that some features are only partially supported in Word for the web compared to the desktop client. This aligns with the behavior observed: the same content is editable in Word desktop but becomes effectively read-only in Word for the web.

    From the provided information, there is no documented OOXML property or specific SDT/OMML structure that guarantees editability of equations inside content controls in Word for the web. The behavior is consistent with a product limitation in the web editor rather than a missing flag or schema error.

    Given this, the practical guidance is:

    1. Treat equations inside SDTs in programmatically generated documents as a scenario that is only partially supported in Word for the web.
    2. Where web editability is required, avoid wrapping OMML equations in SDTs in the generated documents, or provide an alternate authoring path (e.g., edit in Word desktop, which fully supports the construct).
    3. If web editing is critical and SDTs are required for other reasons, consider redesigning the document model so that equations are not directly inside SDTs when the document is intended primarily for Word for the web.

    There is no evidence in the provided documentation of a specific OOXML structure or property that can be added to make these programmatically generated, math-containing content controls editable in Word for the web.


    References:

    Was this answer helpful?

Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.