OmniDocHow to Update a Table of Contents in a Word (.docx) File
Learn how to update a table of contents in a Word .docx file after edits, so page numbers and headings match. Steps, checks and fixes included.
If you have ever added a section to a report and then found that the table of contents still lists the old page numbers, you have run into a refresh problem, not a formatting problem. Students, project managers and anyone who writes long contracts or manuals often edit the body text, move a chapter or delete an appendix, and then forget that the table of contents does not update itself. This guide is for people working in Word (.docx) files who need the page numbers and headings in that table to match the document again.
The short answer is that you update the table with the program's built-in table-of-contents update command, after you have confirmed that every heading uses a heading style. Updating is a separate task from editing the table's look. You do not need to change fonts, spacing or indentation to refresh the page numbers, and an update can overwrite small manual changes you made to the entries.
How do you update a table of contents in a Word (.docx) file? The short answer
Click inside the table, run the update command, and choose the option that matches what changed. The table below shows the common situations.
| Your situation | What to do | Why |
|---|---|---|
| You edited text but added no headings | Refresh page numbers only | Headings are the same, so only the page references need refreshing. |
| You added, removed or renamed headings | Rebuild the entire table | The list of entries itself has changed, and page numbers may have moved too. |
| A new heading is missing from the table | Apply a heading style to it, then update | The table reads heading styles, so a heading formatted by hand is skipped. |
| You restructured chapters or moved sections | Rebuild the entire table, then check every entry | Moved text can shift several pages at once. |
| The table shows the wrong format after updating | Reapply your table style, then refresh page numbers only | Formatting and content are separate; this keeps the layout you chose. |
Before you start
Check these things first. Each one prevents a common reason the update seems to do nothing or produces the wrong result.
- Confirm your headings use heading styles. The table of contents is built from paragraphs with built-in heading styles (such as Heading 1 and Heading 2). A line that only looks like a heading, because it is bold and large, will not appear in the table.
- Save a copy of the file. An entire-table update rebuilds the entries, and manual edits you made to the table text will be replaced. A copy lets you compare or recover the earlier version.
- Finish major edits before updating. Updating after every small change wastes time. Make your structural changes first, then update once at the end.
- Know which pages the table should cover. If your cover page or contents page is numbered differently from the body, check the section settings, because the update uses the page numbers the document currently shows.
- Check the source of the file. If the document was created or converted by another tool, some headings may use direct formatting instead of styles. Open a few headings and see which style they use before you rely on the table.
Updating the table of contents, step by step
- Open the .docx file and find the table of contents. Scroll to the contents page and confirm that it is an automatic table, not a set of typed lines. Typed lines will not update.
- Click anywhere inside the table. The update command usually works on the table you are in, so a click in the table text is enough.
- Find the update command. Desktop office suites place it near the table when you click inside it, or in the references or insert area of the ribbon. Look for a label that mentions updating the table.
- Refresh only the page numbers for small edits. Use this option when you changed body text but did not add, remove or rename any headings. It is faster and keeps your current entry text.
- Rebuild the entire table for structural changes. Use this option after you add, delete or rename headings or move sections. It rebuilds the entries from the headings in the document.
- Confirm the update when prompted. Some programs ask whether to keep manually edited entries. If you typed changes into the table itself, decide whether you want to keep them or let the rebuild replace them.
- Scroll through the table once. Make sure the update finished and the table now shows the headings and page numbers you expect.
Check the result
After the update, compare the table with the document. A quick check takes a few minutes and catches most problems.
| Check | How to see it | If it's wrong |
|---|---|---|
| Every heading appears | Compare the table's entries with the headings in the body | Apply a heading style to the missing heading, then rebuild the entire table. |
| Page numbers match | Open the page listed for three or four entries and find the heading | Refresh page numbers only. If the numbers still differ, check for page breaks or section settings that restart numbering. |
| Entries are in order | Read the table from top to bottom | Move the headings in the document, not the table, then rebuild the entire table. |
| No stray or duplicate entries | Look for headings used twice or for captions styled as headings | Change the style of the stray paragraph to normal text, then update. |
| Layout stayed the same | Check indentation, tab leaders and font | Reapply your table style, then refresh page numbers only so the look stays intact. |
If the table is still wrong after a full update, the cause is usually in the document, not the table. Look for headings formatted by hand, sections that break numbering, or text boxes that hold headings the table cannot read.
For files you edit in a web editor, check the table after you open the file. Heading styles and the update behavior may differ from a desktop program, so treat the table as something to verify rather than assume.
❓ FAQ
1. Why does my table of contents not update when I click the update command?
A common cause is that the headings are not formatted with heading styles. The table only reads paragraphs that use styles such as Heading 1 and Heading 2. Apply the right style to the heading and run the update again.
2. Will updating the table change its formatting?
An entire-table update rebuilds the entries and can replace manual changes to their text. Page-number-only updates keep the entries as they are. If the look changes, reapply your table style and refresh page numbers only.
3. What if the page numbers are right in the table but wrong on the page?
Check whether the page numbers in the document are restarting or offset, for example by a cover page or a separate front-matter section. The table reports the numbers the document currently shows, so fix the numbering in the section settings first.
4. Can I update only one entry?
Not with the automatic table. Update the whole table or only the page numbers, then check the single entry. If you need a one-line change that will not survive updates, you can edit that line, but it will be overwritten the next time you rebuild the entire table.
📝 Summary
A table of contents stays accurate only when you update it after the document changes. Confirm that your headings use heading styles, refresh only the page numbers for small edits and rebuild the entire table for structural ones, then check a few entries against the pages. Doing this once at the end of each editing round keeps the table of contents in Word files matching the document.
