Vendor-neutral guide

DITA on SharePoint, and the case for it

Most DITA platforms run on vendor-proprietary repositories. A minority run on SharePoint, using your Microsoft 365 tenant as the substrate. This is the guide to that pattern.

Architecture

What "DITA on SharePoint" actually means

DITA on SharePoint means storing DITA components (topics, maps, content references) as items inside SharePoint document libraries, using SharePoint as the persistence and security substrate, and assembling DITA-conformant outputs from the components stored there. Three things are not changing in this architecture.

The DITA model is unchanged

Topics, maps, content references, ditavals, profiling: the OASIS DITA standard is the content model. Content authored against this architecture is portable to any DITA-compliant tool, not a SharePoint-specific format dressed up as DITA.

The DITA toolchain is unchanged

Publishing uses the DITA Open Toolkit (DITA-OT), the canonical open-source DITA processor, plus whatever output formats the organization requires: HTML5, PDF, regulatory submission formats like eCTD or SPL.

Approval and reuse are unchanged

Single-source content, component-level versioning, fragment-level traceability, multi-output publishing: the CCMS properties that justify DITA at all.

What does change is the substrate underneath all of that. Instead of a vendor-proprietary content repository, the storage is SharePoint. Instead of a vendor-specific identity model, the access control is the customer's existing Entra ID and SharePoint permissions. Instead of vendor-managed data residency, the data residency is whatever the customer's Microsoft 365 tenant is configured for.

The structural case

What this gives you that a separate platform does not

For an organization already standardized on Microsoft 365, the architectural case for SharePoint-native CCMS is structural rather than featural. Five concrete consequences:

One procurement, not two

SharePoint is already procured, security-reviewed, and operating. The CCMS adds the DITA component layer on top of an approved platform rather than constituting a parallel platform that has to be approved separately. For regulated-industries customers this typically removes six to twelve months from the implementation timeline.

One identity model

Authentication, authorization, conditional access, MFA, and role assignments use the same Entra ID groups already provisioned for SharePoint. No parallel joiners-movers-leavers process, no quarterly reconciliation between two identity stores, no orphaned accounts from a separated CCMS access regime.

One data-residency posture

If your Microsoft 365 tenant is provisioned in EU North or West Europe (or the equivalent for any other Microsoft region), your DITA components are too. If you have moved to a national cloud (Microsoft Cloud Germany, US Government, China 21Vianet), the CCMS moves with the rest of the tenant, no separate vendor-side approval needed.

One audit framework

SharePoint audit logs, Microsoft Purview retention and eDiscovery, and the customer's existing audit tooling cover the CCMS content as a first-class citizen. Data Loss Prevention and information-protection policies apply to it on the same terms. The "we need a second SIEM connector for the CCMS" conversation does not happen.

One disaster-recovery posture

Whatever backup, point-in-time restore, and BCDR procedures the organization has approved for SharePoint apply to the CCMS content. No second BCDR plan to write and test.

The combined effect is not "the CCMS is easier to operate" (though it is). The combined effect is that the organization is operating one content platform, with the CCMS extending it, rather than two content platforms that have to be reconciled.

The IT conversation

What changes in the IT review

The IT review of a SharePoint-native CCMS is structurally different from the review of a dedicated CCMS platform. A useful way to frame it for IT stakeholders: every line below is already decided by the customer's own tenant configuration, and the CCMS simply inherits the answer.

Data residency and sovereignty

Set by the customer's Microsoft 365 tenant configuration.

Identity and access control

Set by the customer's Entra ID and SharePoint permissions model.

Audit logging and eDiscovery

Set by the customer's Microsoft Purview configuration.

Encryption at rest and in transit

Set by SharePoint's defaults and any customer-managed-key configuration.

Backup and disaster recovery

Set by the customer's SharePoint backup and BCDR posture.

Network architecture

Set by the customer's tenant networking: Private Endpoints, conditional access, IP allow-lists, on-premise gateways.

What remains for the IT review is the CCMS application itself: the Word add-in, the workflow engine, the DITA processing pipeline, the administration UI. These are evaluated as a SharePoint application (which IT departments have well-developed procedures for) rather than as a parallel platform.

The authoring half

Word as the authoring surface, SharePoint as the substrate

SharePoint-native storage solves the IT half of the CCMS adoption problem. It does not solve the author half, and the two have to land together: the substrate decision is wasted if subject matter experts will not author in the first place.

Microsoft Word is the authoring surface that pairs naturally with it. SMEs stay in the tool they already use, the DITA structure is applied behind the scenes, and the Word add-in saves components back to SharePoint.

Two viable paths, one with less adoption risk

A dedicated XML editor for a small specialist team, alongside a Word-based path for the SME majority, is also defensible. Word simply minimizes the adoption risk that drives most CCMS programs off the rails.

The case predates this architecture: Word has been the most-used XML editor in the world since Office 2007. The SharePoint-native pattern lines that up with the storage the customer already runs.

See Structured authoring in Microsoft Word for the architectural case, and DITA without an XML editor for the SME view.

The deployment matrix: where a SharePoint-native CCMS can sit

One of the structural advantages of SharePoint as the substrate is that SharePoint itself deploys in more configurations than almost any other content platform. A SharePoint-native CCMS inherits the full matrix.

DeploymentWhat decides data residency and access
SharePoint Online (Microsoft 365 commercial) The default for most customers. Tenant data residency configured at provisioning; conditional access and identity managed through the customer's existing Microsoft 365 controls.
SharePoint Online (Education and Government) Tenanted in dedicated environments for education and government customers, with the same SharePoint surface.
SharePoint Online (national clouds) Microsoft Cloud Germany, US Government Community Cloud (GCC, GCC High, DoD), and China 21Vianet operate as separate Microsoft Online environments with national-jurisdiction data residency.
SharePoint Server on-premise For organizations that operate SharePoint on their own infrastructure, often for regulatory or sovereignty reasons. The SharePoint-native CCMS runs on the same server estate.
SharePoint Server, air-gapped or restricted For defense, nuclear, and high-classification customers where the content platform cannot reach the public internet.
Hybrid SharePoint topologies Mixed cloud and on-premise estates, often because some content classifications can sit in the cloud and others cannot.

A SharePoint-native CCMS supports all six configurations under one product line. SaaS-only CCMS vendors support the first one and disqualify themselves from the others. As data sovereignty requirements tighten across regulated industries, the deployment matrix becomes a structural advantage rather than a feature.

Counter-arguments

The honest case against

SharePoint-native CCMS architecture is not the right answer for every organization. Three legitimate counter-arguments:

You are not on Microsoft 365

If the organization runs on Google Workspace, on a pure cloud-native stack with no Microsoft estate, or on a sovereign content platform that is not SharePoint, the SharePoint-native architecture forces a Microsoft commitment that may not exist today. A vendor whose platform matches the customer's existing substrate is a better fit.

You have decided to move off SharePoint

A small number of customers are leaving SharePoint for strategic reasons. For those customers, layering a CCMS on top of SharePoint is the wrong direction. The honest answer is to evaluate non-SharePoint CCMS options.

You want the vendor to run everything

Some customers prefer a vendor-hosted SaaS posture where the CCMS vendor takes operational responsibility for the storage substrate as well as the application. A SharePoint-native CCMS deliberately puts the substrate in the customer's hands, a feature for most regulated-industries buyers, a friction for a small number of others.

For organizations standardized on Microsoft 365 with no active plan to move off it (the substantial majority of regulated-industries customers) the SharePoint-native architecture is the right answer. For everyone else, the standard CCMS comparison criteria apply; see Choosing a CCMS.

How Dx5 implements this architecture

DitaExchange Dx5 is the CCMS implementation of this architecture. Built since 2007 against the SharePoint substrate; in production with customers across life sciences (MagVenture), aerospace and defense (EASA since 2018, Lockheed Martin, Fokker / GKN), public services (Canadian Nuclear Safety Commission, European Defence Agency), and financial services (LSEG, ICBC).

For the category-level treatment of CCMS independent of any specific vendor, see Component Content Management System, the definitive guide. For the wider product context, Dx5 Overview.

Frequently asked questions

What does running DITA on SharePoint actually mean?

It means storing DITA components (topics, maps, content references) as items inside SharePoint document libraries, using SharePoint as the persistence and security substrate, and assembling DITA-conformant outputs (DITA-OT, HTML5, PDF, regulatory submission formats) from the components stored there. The DITA model is unchanged; the substrate is SharePoint rather than a vendor-proprietary content repository.

Why store DITA components on SharePoint instead of a dedicated CCMS repository?

Because the IT-approved data residency, identity model, conditional access, audit-log retention, eDiscovery posture, and disaster recovery framework that the customer's SharePoint already carries continue to apply. A dedicated CCMS repository requires a parallel procurement, security review, and operating model. For organizations already standardized on Microsoft 365 this is a six-to-twelve-month overhead that the SharePoint-native architecture avoids.

Can SharePoint really handle structured DITA content at scale?

Yes. SharePoint scales to hundreds of millions of items per tenant and millions of items per library, well beyond the volume of any documentation program. The architectural question is not raw scale; it is whether the metadata, version history, and approval workflows that a CCMS needs can be expressed in SharePoint primitives. They can. DitaExchange has been doing it in production since 2007.

Does running DITA on SharePoint lock you into Microsoft?

No. The DITA content stored in SharePoint is portable DITA XML, readable by any DITA-compliant tool. The SharePoint substrate is the storage and security layer, not the content format. An exit from SharePoint is a SharePoint export (well-documented and supported by Microsoft tooling) plus pointing a different DITA-aware system at the exported content. The structural protection of DITA-standard storage applies regardless of which platform holds the components.

What about on-premise, sovereign cloud, and air-gapped environments?

SharePoint Server runs on-premise; Microsoft 365 national clouds serve sovereign environments (US Government, Microsoft Cloud Germany, China 21Vianet); SharePoint Server can be deployed in air-gapped configurations for defense, nuclear, and high-classification customers. A SharePoint-native CCMS inherits all of those deployment options under one product line, which most cloud-only CCMS vendors cannot offer at all.

One platform, not two

For organizations already on Microsoft 365, it is the difference between one content platform with a CCMS layer and two platforms to reconcile: months off the timeline, and a simpler IT posture.