Formatting Issues

Include Custom Styles in a Microsoft Word Table of Contents

Steve KSteve K Nov 20, 2026 870 views

Question details

Include headings that use custom styles in a Microsoft Word table of contents.

Include Custom Styles in a Microsoft Word Table of Contents
Product
Microsoft Word
Device & OS
not provided
Scenario
A document uses custom styles instead of the built-in Heading 1 through Heading 9 styles.
Observed behavior
The table of contents should display text using the custom styles at the desired levels.
Before you start

Apply each custom style to the headings you want to include. Decide which table-of-contents level, from 1 through 9, each style should use.

Solution 1Recommended

Map custom styles to table-of-contents levels

Use this method to include custom styles without changing their paragraph outline levels.

1
Open the custom table settings

Place the cursor where you want the table, then select References > Table of Contents > Custom Table of Contents.

2
Assign style levels

Select Options. Under Available styles, find each custom style and enter its desired number in the TOC level box. Clear a level number if you do not want that style included.

3
Set the displayed depth

Select OK, then set Show levels to include the deepest level you assigned. Select OK to insert or replace the table.

4
Update the table when needed

After changing headings, select the table of contents, choose Update Table, and select Update entire table.

Map custom styles to table-of-contents levels
Work with custom headings in WPS Writer

Build a table of contents from custom styles in WPS Writer

Use WPS Writer to assign heading levels to custom styles and create a table of contents for your document.

  1. 1. Open the document: Open WPS Writer and select Open to load your Word document.
  2. 2. Set heading levels: On the Home tab, modify each custom heading style and use Format > Paragraph to assign its outline level.
  3. 3. Insert the table: Place the cursor where the table belongs, then select References > Table of Contents and choose a table-of-contents option.
  4. 4. Refresh the entries: After editing headings, select the table of contents and use its update command to refresh the entries.
Organize custom headings into table-of-contents levelsOpen and save Microsoft Word DOC and DOCX filesUse a familiar, easy-to-navigate document editorWork with a free, lightweight office suite
microsoft office alternative - wps office

Frequently Asked Questions

Do custom styles have to be based on Heading 1 or Heading 2?

No. In Word, you can map a custom style directly to a TOC level through References > Table of Contents > Custom Table of Contents > Options, or assign it a paragraph outline level.

Why is my custom heading missing from the table of contents?

Check that the heading has the intended custom style applied. Then open Custom Table of Contents > Options and confirm that the style has a TOC level, or that its outline level is enabled.

How many levels can a Word table of contents show?

Word supports up to nine levels. In References > Table of Contents > Custom Table of Contents, set Show levels to the depth you need.

How do I refresh the table after adding headings?

Select the table of contents, choose Update Table, and select Update entire table to refresh both headings and page numbers.