Word's Table of Contents won't update — fix the field code

A grad student in Ann Arbor sent me her dissertation draft last March. 287 pages. Five years of work. She was three days from her defense. The Table of Contents said her conclusion started on page 198. The conclusion was actually on page 234. F9 did nothing. She'd already cried about it.

I fixed it in about four minutes. Then I made her a cup of tea over Zoom while she calmed down.

The Word TOC is a field code. Field codes are little programs embedded in your document — they calculate something (a page number, a date, a cross-reference) and display the result. The TOC field is one of the more complex ones because it has to scan the entire document, find every heading, and build a list with current page numbers. When it gets stuck, it's almost always one of four problems.

Update page numbers vs update entire table

Right-click anywhere on the TOC. You get a tiny menu. One of the options is "Update Field." Click it and Word asks: "Update page numbers only" or "Update entire table."

These do completely different jobs and people pick the wrong one constantly.

Update page numbers only — keeps the existing list of headings exactly as it was, just refreshes the page numbers next to each one. Use this when you've added or removed content but haven't changed any headings. Faster.

Update entire table — rebuilds the whole TOC from scratch, scanning the document for every heading-styled paragraph. Use this when you've added new headings, deleted headings, renamed headings, or restructured your document. Slower but always correct.

If in doubt, pick Update entire table. The speed difference doesn't matter unless your document is hundreds of pages with hundreds of headings. Just rebuild it.

The grad student's problem was that she'd been clicking "Update page numbers only" for months. She'd added two new chapters and renamed three. Page numbers updated fine but the TOC still listed the old chapter names and was missing the new ones. Update entire table fixed it in one click.

F9 and why your cursor matters

F9 is the keyboard shortcut for Update Field. Faster than right-clicking. But it has a catch that nobody explains: the cursor has to be inside the field for F9 to update that field.

Click somewhere in the body of your TOC. Anywhere — on a heading name, on a page number, on the dotted leader between them. Then press F9. Word pops up the same Update Field dialog and you pick page numbers or whole table.

If your cursor is outside the TOC when you press F9, nothing visible happens. Word might be updating some other field code somewhere else in the document — a date field, a cross-reference — but it's not touching the TOC. People press F9 with their cursor in the document body, see nothing change, and assume F9 is broken.

Ctrl+A then F9 selects the entire document and updates every field at once. This is the nuclear option and it works, but on a long document with lots of fields it can take a long minute. Useful when you've genuinely changed everything and want one button to fix the whole document.

Toggling field codes with Alt+F9

Sometimes the TOC isn't behaving and you can't tell why. Press Alt+F9 and Word switches every field in the document to display its raw code instead of its result. Your TOC turns into something like:

{ TOC \o "1-3" \h \z \u }

This is the actual instruction Word is running to build the TOC. Press Alt+F9 again to toggle back to the rendered view.

The codes you'll see vary. The \o "1-3" means "include heading levels 1 through 3." Change it to \o "1-4" and you'd include Heading 4 too. The \h means hyperlinked. The \z is for hiding tab leaders in web layout. The \u is for outline levels.

If your TOC is missing what you'd expect — like, you've got Heading 4s that aren't showing up — Alt+F9, look at the \o range, fix it. This is the most direct way to control what the TOC includes without going through the dialog box.

Built TOC vs manual TOC

There are two kinds of TOC in Word and they behave totally differently. References tab → Table of Contents gives you a dropdown. The first two options ("Automatic Table 1" and "Automatic Table 2") build a real TOC field that scans for heading styles. The third option ("Manual Table") is fake — it's just a template with placeholder text that you type into yourself.

If you've got a Manual Table, F9 will do nothing because there's no field to update. There's nothing dynamic happening at all. It's just text shaped like a TOC. You have to manually edit it every time anything changes.

I see this on documents people inherit. Someone built the original document, used Manual Table without realizing what it was, typed everything in by hand. Six revisions later the new owner is confused why nothing updates. The fix is to delete the manual table and insert one of the automatic ones from the dropdown.

How to tell which one you have: click on the TOC. If a gray box appears around the whole thing and there's a little tab at the top saying "Update Table" — that's an automatic TOC. If you can just click into individual lines and edit the text directly with no gray box behavior — that's a manual TOC.

Heading styles are non-negotiable

The automatic TOC only includes paragraphs that are formatted with the Heading styles — Heading 1, Heading 2, Heading 3 by default. Not "text that looks like a heading because you made it bold and 16pt." It has to actually have the Heading style applied.

This trips people up constantly. They format a chapter title to look exactly like the other chapter titles — same font, same size, same bold — but they did it manually instead of applying Heading 1. The TOC ignores it.

Fix: select the heading text, then in the Styles gallery on the Home tab, click Heading 1 (or whichever level it should be). Now it's a real heading and the TOC will pick it up on the next refresh.

There's also a workaround for headings you want in the TOC but don't want formatted as Word's heading styles. References tab → Add Text. Pick a level. This adds the paragraph to the TOC without changing how it looks. Useful for things like preface sections or appendix titles where you want the formatting to be different but still want them in the TOC.

Corrupted field codes

Sometimes a TOC just goes weird. Doesn't update. Shows error messages like "Error! Bookmark not defined." Displays page numbers that don't make sense. The field has corrupted somehow — usually because the document has been through multiple Word versions, or got opened in an alternate editor at some point, or the bookmarks the TOC references got deleted.

Nuclear option: convert the field to plain text and start over. Click in the TOC. Press Ctrl+Shift+F9. The field becomes static text — no more dynamic updating, just literal text where the TOC used to be. Then delete that text, go to References → Table of Contents, and insert a fresh one.

This loses any custom formatting you'd applied to the old TOC, so you'll need to re-style it. But it gets you out of corruption hell, which is sometimes the only option.

Inherited documents from older Word versions

If you're working with a document that started life in Word 2007 or earlier and has been carried forward over the years, the TOC field can have ancient parameters that don't play nicely with current Word. Bookmarks from the old version that no longer exist. Style references that point to renamed styles. Hidden formatting that doesn't render the way it used to.

When this happens the TOC sometimes refuses to update at all, or updates but shows blank entries, or builds a TOC that's missing half your headings.

The fastest fix is usually to convert the document to a current format. Save As → pick the modern .docx format if it's still a .doc, or just save with a new filename even if it's already .docx. Sometimes that round-trip is enough to clean up the legacy junk. If not, the Ctrl+Shift+F9 nuclear option from above usually does it.

The "update fields before printing" setting

This one's annoying. Word has a setting at File → Options → Display → "Update fields before printing." If it's off (which is the default in some installations), you can print a document with a totally outdated TOC and Word won't warn you. People send out 200-page reports with TOCs pointing to wrong page numbers because of this.

I'd turn it on. The mild inconvenience of Word taking an extra second before printing is worth not embarrassing yourself with a wrong TOC in the printed copy.

There's also a related setting in the Print dialog itself, but the global option is more reliable. Just set it once and forget it.

Section breaks and TOCs

This is the weird one. If your TOC sits inside a section break with different page numbering than the rest of the document — say, the front matter uses Roman numerals and the body uses Arabic — the TOC sometimes shows page numbers from the wrong sequence. Or shows them all as Roman. Or as 1, 2, 3 starting from wherever the section starts.

This is genuinely a Word bug that's existed for years and Microsoft has never properly fixed. The workaround is to make sure your TOC sits in a section that's set to use Arabic page numbers (or whatever numbering you want it to display), even though the TOC itself is showing page numbers from elsewhere in the document. Insert tab → Page Number → Format Page Numbers → set the format and starting number for the section the TOC lives in.

I won't pretend this always works on the first try. Section breaks and Word are an unhappy marriage. If you've got a TOC misbehaving in a complex document with multiple sections, sometimes you just have to fiddle with the section settings until it stabilizes. Save first.

What to remember

Right-click → Update Field → entire table covers 80% of cases. F9 with cursor inside the TOC covers another 15%. The rest are the weird ones — corrupted fields, manual tables masquerading as automatic ones, section break ghosts.

The grad student got her TOC sorted in time for her defense. She passed. She emailed me a photo of her diploma in May. Her dissertation TOC was, on that day, fully accurate. Worth the four minutes.