Extract metadata from Microsoft Office Word documents Leave feedback

Word document metadata is hidden information stored inside your .doc and .docx files. It’s like a “digital fingerprint” that contains details about the document such as:

• Who wrote the document
• When it was created and last modified
• How much time was spent writing it
• The document’s title, subject, and keywords
• Which version of Word was used

You can see some of this information by right-clicking a Word file and selecting “Properties” - but with GroupDocs.Parser, you can extract this data programmatically using Java code.

Here are common scenarios where extracting Word metadata is useful:

Document management:

• Automatically organize documents by author or creation date
• Build searchable document libraries
• Track document versions and changes

Business applications:

• Find all documents created by a specific employee
• Monitor document editing activity
• Ensure proper document attribution

Compliance and auditing:

• Track document history for legal requirements
• Monitor sensitive document access
• Maintain document lifecycle records

The getMetadata method can extract these details from Word documents:

Properties that are empty in the document are not included in the result.

It’s simple! Just follow these 3 steps:

Instantiate the Parser object for your Word document:

try (Parser parser = new Parser("your-document.docx")) {
    // Your code goes here
}

Call the getMetadata method to obtain the collection of MetadataItem objects:

Iterable<MetadataItem> metadata = parser.getMetadata();

Loop through the collection and print metadata names and values:

for (MetadataItem item : metadata) {
    System.out.println(item.getName() + ": " + item.getValue());
}

Here’s the full code that extracts and displays all metadata from a Word document:

// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleDocx)) {
    // Extract metadata from the document
    Iterable<MetadataItem> metadata = parser.getMetadata();
    // Iterate over metadata items
    for (MetadataItem item : metadata) {
        // Print an item name and value
        System.out.println(String.format("%s: %s", item.getName(), item.getValue()));
    }
}

Warning

getMetadata method returns null value if metadata extraction isn’t supported for the document. For example, metadata extraction isn’t supported for Zip archive. Therefore, for Zip archive getMetadata method returns null. If Microsoft Office Word document has no metadata, getMetadata method returns an empty collection.

This works with all common Microsoft Word formats:

• .doc - Older Word documents (Word 97-2003)
• .docx - Newer Word documents (Word 2007 and later)
• .dot - Word document templates
• .dotx - Word template files

Let’s say you want to find all Word documents in a folder that were created by a specific person:

try (DirectoryStream<Path> documents = Files.newDirectoryStream(Paths.get("C:\\MyDocuments"), "*.docx")) {
    for (Path document : documents) {
        try (Parser parser = new Parser(document.toString())) {
            Iterable<MetadataItem> metadata = parser.getMetadata();
            if (metadata == null) {
                continue;
            }
            for (MetadataItem item : metadata) {
                if ("author".equals(item.getName()) && "John Smith".equals(item.getValue())) {
                    System.out.println("Found document by John Smith: " + document.getFileName());
                }
            }
        }
    }
}

Create a summary report showing key information about your Word documents:

try (Parser parser = new Parser("report.docx")) {
    Iterable<MetadataItem> metadata = parser.getMetadata();

    System.out.println("=== Document Summary ===");
    System.out.println("Title: " + getValue(metadata, "title"));
    System.out.println("Author: " + getValue(metadata, "author"));
    System.out.println("Created: " + getValue(metadata, "created-time"));
    System.out.println("Last Modified: " + getValue(metadata, "last-saved-time"));
    System.out.println("Total Editing Time: " + getValue(metadata, "total-editing-time") + " minutes");
}

private static String getValue(Iterable<MetadataItem> metadata, String name) {
    if (metadata != null) {
        for (MetadataItem item : metadata) {
            if (name.equals(item.getName())) {
                return item.getValue();
            }
        }
    }
    return "Not available";
}

For businesses:

• Track employee document creation and editing activity
• Organize documents by department or project
• Monitor document compliance and approval workflows

For developers:

• Build document management systems
• Create automated file organization tools
• Add document search and filtering capabilities

For content managers:

• Maintain document libraries and archives
• Track document versions and revision history
• Ensure proper document metadata standards

Problem: Not getting any metadata back?

• Solution: The document might not have metadata properties set, or the file format might not support metadata extraction (in this case getMetadata returns null)

Problem: Getting a “file not found” error?

• Solution: Check that the file path is correct and the file exists

Problem: Can’t read password-protected documents?

• Solution: Pass the password with LoadOptions when you create the Parser object. See Password-protected documents for details

Problem: Some metadata fields are missing?

• Solution: This is normal - not all Word documents have all metadata fields populated, and empty fields are not returned

1. Always use try-with-resources to properly close Parser objects
2. Check for null values when the format may not support metadata extraction
3. Handle exceptions for corrupted or inaccessible files
4. Test with different Word versions to ensure compatibility
5. Validate file formats before attempting to extract metadata

You may easily run the code above and see the feature in action in our GitHub examples:

• GroupDocs.Parser for .NET examples
• GroupDocs.Parser for Java examples

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online Free Online Document Parser App.