LibreOffice Writer Master Document Linking Protocols

LibreOffice Writer uses a master document system (.odm) to combine multiple sub-documents (.odt) into a single cohesive work. This article explains the underlying linking protocols, URI schemes, and file management mechanisms LibreOffice Writer employs to reference, synchronize, and display sub-documents within a master document framework.

OpenDocument Format (ODF) XML Linking

At the core format level, LibreOffice Writer adheres to the OASIS OpenDocument Format (ODF) standard. When a sub-document is inserted into a master document via the Navigator, Writer creates a specialized linked section within the document’s XML structure (content.xml).

This connection relies on the text:section-source element using the W3C XLink standard: * xlink:href: Specifies the target URI or file path of the sub-document. * xlink:type="simple": Designates a direct, one-way link to the external source file. * text:filter-name: Defines the import filter used to parse the sub-document contents upon loading.

URI Schemes and File-System Path Resolution

LibreOffice Writer resolves linked sub-documents using standard Uniform Resource Identifier (URI) formats and native operating system paths:

• Relative File Paths: Writer defaults to relative pathing if the master document and sub-documents reside on the same drive or directory tree. This allows entire document directories to be moved or shared without breaking links.
• Absolute File Paths (file://): When documents are located on different drives or separate directory roots, Writer stores absolute paths using standard file:// URI protocol schemes (e.g., file:///C:/Documents/Chapter1.odt or file:///home/user/docs/Chapter1.odt).
• UNC Paths: In Windows environments, Writer supports Universal Naming Convention paths (\\server\share\path\to\file.odt) for network-based sub-documents.

Remote and Virtual File System Protocols (UCP)

LibreOffice includes an abstraction layer called the Universal Content Provider (UCP), which enables master documents to link to sub-documents hosted across various network and cloud protocols:

• WebDAV / HTTP(S): Sub-documents hosted on WebDAV-enabled web servers can be referenced directly using HTTP or HTTPS URIs (http://, https://, or internal vnd.sun.star.webdav:// schemes).
• CMIS (Content Management Interoperability Services): Writer can link to sub-documents stored in enterprise content management systems (such as Alfresco, Nextcloud, or Microsoft SharePoint) using the CMIS protocol bindings.
• FTP / SFTP: Remote sub-documents can be linked over File Transfer Protocol (ftp://) or Secure Shell File Transfer Protocol (sftp://).
• SMB / CIFS: Network shares accessed natively or via the GNOME Virtual File System (GVFS) / KIO layers are supported through smb:// protocols on Linux or UNC paths on Windows.

DDE and OLE Section Linking

In addition to native master document Navigator links, LibreOffice Writer supports alternative linking protocols for bringing external content into master document workflows:

• Dynamic Data Exchange (DDE): Allows a master document to establish a live IPC (Inter-Process Communication) link to specific data fields or sections within another application or document.
• Object Linking and Embedding (OLE): Enables linking sub-components as embedded objects, storing an external pointer rather than embedding raw text sections directly into the document tree.