Reading document properties with VBA

VBA Code Snippets

In the Windows Explorer it is possible to view a document’s properties.  Right-click on the file and select Properties.

There is useful information in here, such as author, creation date, last saved date etc.  The good news is, we can access this information using VBA with  the BuiltinDocumentProperties Property.

Not all document properties are populated with data, as it depends on the file type. For example, Excel files do not have data about the number of slides property, but a PowerPoint file does.  Yet, both Excel and PowerPoint files have a number of slides property, it’s just not used in all circumstances.

The basic VBA code

'Finding the author of the ActiveWorkbook
Debug.Print ActiveWorkbook.BuiltinDocumentProperties("Author")

'Finding the creation date of another workbook
Dim Wb As Workbook
Set Wb = Workbooks("myFileTest.xlsx")
Debug.Print Wb.BuiltinDocumentProperties("Creation date")

Working with closed files

By using the BuiltinDocumentProperties there is no way to read the properties from a closed file.  Therefore it is necessary to open the file, read the properties, then close the file.

'Find the Last saved time of a currently closed file
Dim Wb As Workbook
Set Wb = Workbooks.Open("C:\Users\marks\Documents\myFileTest.xlsx")
Debug.Print Wb.BuiltinDocumentProperties("Last save time")
Wb.Close

Note: Take a look in the comments section below as there appears to be a way to read and change properties on a closed file.  But that is outside the scope of this post.

100 Excel VBA Macros

Do you know the fastest way to learn foreign languages?  It is to read, write, speak, and think in that language as often as possible.  Apart from speaking, programming languages are no different.  The more you immerse yourself in that language, the faster you will pick it up.

100 Excel Macros Book

Therefore, what most people like you need is lots of examples that you can practice.  That is why the 100 Excel VBA Macros eBook exists.  It’s the book for all Excel users who want to learn how to read and write Excel macros, save time, and stand out from their peers.  The book contains:

  • 100 example codes to practice reading and writing macros that will embed the language into your thinking.
  • An introduction to macros in Excel to ensure you can implement the VBA code in the book even if you have no prior knowledge.
  • Consistent code layout between examples to enable you to understand the structure and easily customize the code to meet your needs.
  • Downloadable workbook containing all the source code, so the examples can be added to your project to give you the benefit of VBA straight away.

Catching errors

Referencing a property which does not have any information will throw and error.

Builtin Properties - Catching Error

It is possible to catch the errors so that you know the value is blank:

'Catching errors when there is no value
Dim fileProperty As Variant
fileProperty = "Number of slides"

On Error Resume Next
Debug.Print ActiveWorkbook.BuiltinDocumentProperties(fileProperty)
If Err.Number <> 0 Then
    Debug.Print fileProperty & " is blank"
End If
On Error GoTo 0

All the available properties

The available properties are:

Title
Subject
Author
Keywords
Comments
Template
Last author
Revision number
Application name
Last print date
Creation date
Last save time
Total editing time
Number of pages
Number of words
Number of characters
Security
Category
Format
Manager
Company
Number of bytes
Number of lines
Number of paragraphs
Number of slides
Number of notes
Number of hidden Slides
Number of multimedia clips
Hyperlink base
Number of characters (with spaces)
Content type
Content status
Language
Document version

It is also possible to loop through and list all of the available properties:

'List all the file properties available
Dim fileProperty As Variant
For Each fileProperty In ActiveWorkbook.BuiltinDocumentProperties
    Debug.Print fileProperty.Name
Next fileProperty



Get our FREE VBA eBook of the 30 most useful Excel VBA macros.
Automate Excel so that you can save time and stop doing the jobs a trained monkey could do.

Email Address * First Name *

By entering your email address you agree to receive emails from Excel Off The Grid. We’ll respect your privacy and you can unsubscribe at any time.


Don’t forget:

If you’ve found this post useful, or if you have a better approach, then please leave a comment below.

Do you need help adapting this to your needs?

I’m guessing the examples in this post didn’t exactly meet your situation.  We all use Excel differently, so it’s impossible to write a post that will meet everybody’s needs.  By taking the time to understand the techniques and principles in this post (and elsewhere on this site) you should be able to adapt it to your needs.

But, if you’re still struggling you should:

  1. Read other blogs, or watch YouTube videos on the same topic.  You will benefit much more by discovering your own solutions.
  2. Ask the ‘Excel Ninja’ in your office.  It’s amazing what things other people know.
  3. Ask a question in a forum like Mr Excel, or the Microsoft Answers Community.  Remember, the people on these forums are generally giving their time for free.  So take care to craft your question, make sure it’s clear and concise.  List all the things you’ve tried, and provide screenshots, code segments and example workbooks.
  4. Use Excel Rescue, who are my consultancy partner.   They help by providing solutions to smaller Excel problems.

What next?
Don’t go yet, there is plenty more to learn on Excel Off The Grid.  Check out the latest posts:

2 thoughts on “Reading document properties with VBA

    • Excel Off The Grid says:

      Hi Roy,

      Thanks for the question. I must admit that I’ve not tried. It’s outside my current knowledge and skill level. It is something I will look into, as it’s always good to learn.

      I will add a comment to the post to clarify that it’s only referring to the basic BuiltinDocumentProperties properties.

Leave a Reply

Your email address will not be published. Required fields are marked *