Word table of contents not updating: how to fix it

Quick answer: A Word table of contents is a field built from heading styles, and it doesn’t refresh itself as you type. Click inside it, select References > Update Table, choose Update entire table and select OK. If a heading still doesn’t appear, give it a heading style such as Heading 1 from the Home tab and update again. If the table never changes at all, it may have been typed by hand, which Word can’t update, or the field may be locked.

Applies to: Word for Microsoft 365 on Windows and Mac, Word 2024, Word 2021, Word 2019 and Word 2016, the versions Microsoft lists for its update steps. Menu names in the desktop app on Windows are used below; the Mac and web differences are near the end.

Match your symptom

Find the line closest to what you see, then jump to that fix.

What you seePossible causeGo to
New or renamed headings don’t show after you updatePage numbers only was chosenFix 1
One heading never appearsThe heading has no heading styleFix 2
Heading 3 or Heading 4 entries are missingShow levels is set too lowFix 3
Normal paragraphs or empty lines appear as entriesOutline level or style on body textFix 4
The table doesn’t change, or Update Table isn’t thereManual table or locked fieldFix 5
{ TOC \o “1-3” \h \z \u } or an Error! messageField codes view or no headings foundFix 6
Entries are right but page numbers are wrongMarkup, hidden text or field codes on screenFix 7

Fix 1: Update the whole table, not just page numbers

Microsoft’s update a table of contents article describes two update modes, and picking the wrong one explains a table that keeps old heading text:

  1. Click anywhere in the table of contents.
  2. Select References > Update Table.
  3. Choose Update entire table. Update page numbers only refreshes the numbers but ignores any change to the heading text, so new or renamed headings stay out.
  4. Select OK.

You can also right-click the table and choose Update Field, as Microsoft’s insert a table of contents article suggests, or click in it and press F9. Both open the same choice between page numbers and the entire table. As general guidance, any formatting you applied directly to entries, such as a bold line or a changed font, may be lost when you update the entire table, so make lasting style changes through the table’s own styles instead.

Fix 2: A heading is missing from the table

Word only collects text that’s formatted as a heading. Microsoft’s insert article names this as the reason entries go missing. Text that only looks like a heading, because it’s bold and larger, isn’t picked up.

  1. Select the heading text that’s missing.
  2. On the Home tab, in the Styles group, choose Heading 1 (or Heading 2 for a subheading).
  3. Update the table with Update entire table.

If the style changes the look of the heading in a way you don’t want, as general guidance you can right-click Heading 1 in the Styles gallery and choose Modify to change its font and size for the whole document. That keeps the heading in the table while matching your design. Headings inside text boxes or shapes may also be skipped; as general guidance, move such a heading into the main text if it needs an entry.

Fix 3: Lower-level headings don’t appear

The automatic tables show a set number of heading levels. As general guidance, the built-in styles include Heading 1 to Heading 3, so a Heading 4 is left out until you raise the limit:

  1. Select References > Table of Contents > Custom Table of Contents.
  2. Set Show levels to the deepest heading level you use, for example 4.
  3. Select OK. Word asks whether to replace the current table; choose Yes.

As general guidance, dialog names may vary slightly by version. If you built the document on custom styles rather than the built-in headings, the Options button in the same dialog may let you assign a table level to each of your styles.

Fix 4: Body text or blank lines show up as entries

The opposite problem, extra lines in the table, can come from paragraphs that carry a heading style or an outline level they shouldn’t have. As general guidance:

  • A body paragraph in the table: click in that paragraph in the document and check the Styles gallery. If it shows a heading style, apply Normal (or your body style) instead.
  • A paragraph with an outline level: open the Paragraph dialog from the Home tab and look at Outline level on the Indents and Spacing tab. Set it to Body Text for text that shouldn’t appear.
  • An empty entry: an empty paragraph with a heading style can appear as a blank line or a lone page number. Turn on Show/Hide (the button on the Home tab), find the empty marker under the heading, and delete it or give it the Normal style.

Update the entire table after each change so you can see which fix removed the entry.

Fix 5: Nothing changes when you update

  • The table was typed by hand. Microsoft’s update article says Word can’t update a manually created table of contents that isn’t generated from headings. As general guidance, the Manual Table option in the gallery also produces fixed text. Delete it and insert an automatic table from References > Table of Contents.
  • The field is locked. Microsoft’s fields article says Ctrl + F11 locks a field so its result isn’t updated, and Ctrl + Shift + F11 unlocks it. Click in the table, press the unlock shortcut, then update.
  • The table is pasted as text. As general guidance, a table of contents copied from another file and pasted as plain text loses its field. Click in it: a real table gets gray field shading, and Update Table appears above it. If neither happens, replace it with a new automatic table.
  • You select all and press F9, but the table stays the same. The fields article says Ctrl + A then F9 updates the main body only. A table of contents placed in a text box needs its own update, so click inside it first.

If update commands fail in every document, not only one, a damaged Office install is worth ruling out with Quick Repair or Online Repair.

Fix 6: You see field codes or Error! text

If the table turns into a line such as { TOC \o "1-3" \h \z \u }, Word is showing the field code instead of its result. The fields article says Alt + F9 switches between codes and results for the document; on a laptop you may need Fn + Alt + F9. Our guide to finding hyperlinks in Word uses the same view on purpose, so this can happen after following it.

As general guidance, two messages may also appear in place of the table:

  • Error! No table of contents entries found. Word found no text with a heading style. Apply heading styles as in Fix 2, then update the entire table.
  • Error! Bookmark not defined. This can appear next to entries when you update page numbers only after headings were deleted or moved. Choose Update entire table to rebuild the links. If the text stays, press Ctrl + Z right after the update, then fix the headings and update again.

If you’d rather not see the gray background on fields while you work, the fields article places Field shading under File > Options > Advanced, in the Show document content section, with the choices Always, Never and When selected.

Fix 7: Page numbers in the table are off

When entries are correct but numbers point to the wrong page, Word may be counting pages from a layout that differs from the final one. As general guidance, check these:

  • Tracked changes or comments on screen: deleted text and comment balloons shown in All Markup can push headings to later pages. Switch the view to Simple Markup or No Markup on the Review tab, then update the page numbers. Our guide to Word track changes not showing explains those views.
  • Hidden text or field codes visible: text formatted as hidden, or field codes shown with Alt + F9, takes up space on screen. Hide them before you update so the count matches the printed page.
  • The page numbers themselves are wrong: the table copies whatever number each page carries. If a section restarts at 1 or starts at the wrong value, fix the numbering first with our guide to Word page numbers that are wrong, then update the table.
  • Numbers change at print time: as general guidance, Word repaginates with the printer’s layout and some setups refresh fields when you print or export. Our guide to print preview differences in Word covers why a heading can move by a page between the screen and the printout. Updating the table just before you print or save as PDF keeps the numbers in step.

Word for Mac and Word for the web

Microsoft lists Word for Microsoft 365 for Mac under its update steps, so References > Update Table is the place to start there too. The fields article notes that Word for Mac and Word for the web can view or update some fields, but full insertion and editing works only in Word for Windows. As general guidance, if an update option is missing in the browser, open the document in the desktop app, update the table there and save.

Official sources

How we write our guides: read our editorial policy.

Comments

Leave a Reply

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