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.
In this guide
- Match your symptom
- Fix 1: Update the whole table, not just page numbers
- Fix 2: A heading is missing from the table
- Fix 3: Lower-level headings don’t appear
- Fix 4: Body text or blank lines show up as entries
- Fix 5: Nothing changes when you update
- Fix 6: You see field codes or Error! text
- Fix 7: Page numbers in the table are off
- Word for Mac and Word for the web
- Related guides
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 see | Possible cause | Go to |
|---|---|---|
| New or renamed headings don’t show after you update | Page numbers only was chosen | Fix 1 |
| One heading never appears | The heading has no heading style | Fix 2 |
| Heading 3 or Heading 4 entries are missing | Show levels is set too low | Fix 3 |
| Normal paragraphs or empty lines appear as entries | Outline level or style on body text | Fix 4 |
| The table doesn’t change, or Update Table isn’t there | Manual table or locked field | Fix 5 |
| { TOC \o “1-3” \h \z \u } or an Error! message | Field codes view or no headings found | Fix 6 |
| Entries are right but page numbers are wrong | Markup, hidden text or field codes on screen | Fix 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:
- Click anywhere in the table of contents.
- Select References > Update Table.
- 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.
- 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.
- Select the heading text that’s missing.
- On the Home tab, in the Styles group, choose Heading 1 (or Heading 2 for a subheading).
- 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:
- Select References > Table of Contents > Custom Table of Contents.
- Set Show levels to the deepest heading level you use, for example 4.
- 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.
Related guides
- Word page numbers wrong or not showing: how to fix them
- Word track changes not showing: how to fix it on Windows 11
- Print preview different from the document in Word: why and how to fix it
- How to find hyperlinks in Word (every link, fast)
- How to repair Microsoft Office (Quick Repair and Online Repair)
Leave a Reply