Please Note: This article is written for users of the following Microsoft Word versions: 2007, 2010, 2013, 2016, 2019, and 2021. If you are using an earlier version (Word 2003 or earlier), this tip may not work for you. For a version of this tip written specifically for earlier versions of Word, click here: Updating an Entire TOC from a Macro.

Updating an Entire TOC from a Macro

Written by Allen Wyatt (last updated November 16, 2023)
This tip applies to Word 2007, 2010, 2013, 2016, 2019, and 2021


1

If you have a document that contains a table of contents (TOC), and you update the fields in the entire document, Word asks if you want to update the entire table, the chapter entries, or just the page numbers associated with the existing chapter entries in the Table of Contents. This occurs because TOCs are implemented through the use of a field, and when you update all fields you are telling Word you also want to update the field underlying the TOC.

You can update a TOC using a macro by utilizing the TablesOfContents collection. Each item in the collection represents a single TOC in the document. (In most documents the collection will consist of only a single item.) To update the entire TOC, you use this format of the command:

ActiveDocument.TablesOfContents(1).Update

The Update method is what does the work; it updates the TOC. If you want to update only the page numbers in the TOC, you use an entirely different method:

ActiveDocument.TablesOfContents(1).UpdatePageNumbers

Whenever you use commands like these in a macro, it is a good idea to make sure that there is actually a TOC in the document before you try to do any updating. The easiest way to do this is to just check the Count property for the collection, as shown here:

If ActiveDocument.TablesOfContents.Count = 1 Then _ 
  ActiveDocument.TablesOfContents(1).Update

Note:

If you would like to know how to use the macros described on this page (or on any other page on the WordTips sites), I've prepared a special page that includes helpful information. Click here to open that special page in a new browser tab.

WordTips is your source for cost-effective Microsoft Word training. (Microsoft Word is the most popular word processing software in the world.) This tip (8621) applies to Microsoft Word 2007, 2010, 2013, 2016, 2019, and 2021. You can find a version of this tip for the older menu interface of Word here: Updating an Entire TOC from a Macro.

Author Bio

Allen Wyatt

With more than 50 non-fiction books and numerous magazine articles to his credit, Allen Wyatt is an internationally recognized author. He is president of Sharon Parq Associates, a computer and publishing services company. ...

MORE FROM ALLEN

Counting the Times a Worksheet is Used

Do you need to know how many times a worksheet has been used? Excel doesn't track that information, but you can develop ...

Discover More

Converting UTC Times to Local Times

Dates and times are often standardized on UTC time, which is analogous to GMT times. How to convert such times to your ...

Discover More

Showing a Scenario

When you create and save scenarios in a workbook, you can later pull them out and display them. Here's how to do it.

Discover More

Create Custom Apps with VBA! Discover how to extend the capabilities of Office 365 applications with VBA programming. Written in clear terms and understandable language, the book includes systematic tutorials and contains both intermediate and advanced content for experienced VB developers. Designed to be comprehensive, the book addresses not just one Office application, but the entire Office suite. Check out Mastering VBA for Microsoft Office 365 today!

More WordTips (ribbon)

Headings in Tables Not Showing in TOC

Word includes a couple of built-in tools that rely upon the use of heading styles in your document. These tools include ...

Discover More

Stopping the TOC from Appearing in the Navigation Pane

When you create a TOC for your document, the information in the TOC is based on the headings in your document. If you ...

Discover More

Jumping Back to the TOC

Word allows you to create a table of contents that provides hyperlinks to headings within your document. It doesn't make ...

Discover More
Subscribe

FREE SERVICE: Get tips like this every week in WordTips, a free productivity newsletter. Enter your address and click "Subscribe."

View most recent newsletter.

Comments

If you would like to add an image to your comment (not an avatar, but an image to help in making the point of your comment), include the characters [{fig}] (all 7 characters, in the sequence shown) in your comment text. You’ll be prompted to upload your image when you submit the comment. Maximum image size is 6Mpixels. Images larger than 600px wide or 1000px tall will be reduced. Up to three images may be included in a comment. All images are subject to review. Commenting privileges may be curtailed if inappropriate images are posted.

What is 1 + 8?

2025-08-28 11:57:29

Barbie

This worked great, but would have been even more useful if it had addressed the possibility that you do, in fact, have more than one TOC. I tried adapting the code for determining if there is a TOC to update the second one if there are two, etc., but still only the first one was updated. Finally, I was able to find code on another website that indeed steps through and updates all TOCs in a document. This was acceptable, though I would have liked to be able to update just the TOC I have the cursor in... Unfortunately, VBA code is basically a foreign language to me, so I can only make minor adjustments and still have it work.


This Site

Got a version of Word that uses the ribbon interface (Word 2007 or later)? This site is for you! If you use an earlier version of Word, visit our WordTips site focusing on the menu interface.

Videos
Subscribe

FREE SERVICE: Get tips like this every week in WordTips, a free productivity newsletter. Enter your address and click "Subscribe."

(Your e-mail address is not shared with anyone, ever.)

View the most recent newsletter.