A Google Docs table of contents is built automatically from your heading styles: format your section titles as headings, place the cursor where the list should go, and choose Insert > Table of contents. Docs generates a clickable list that you can refresh whenever the document changes. Here is the full process, plus fixes for the problems people hit most often.
Key takeaways
- The table of contents only picks up text that uses heading paragraph styles.
- You can choose a version with page numbers or one with blue links.
- The list does not always refresh by itself, so update it before sharing or printing.
- Menu names may change, so follow the official help page if something looks different.
What a Google Docs Table of Contents Does
A table of contents lists the headings of a document and links each entry to its location. Readers can click an entry to jump straight to that section, which matters in long reports, study guides, handbooks and proposals. In a printed copy, the page-number version lets readers find a section the old-fashioned way.
The feature depends entirely on structure. If your headings are just bold, larger text, Docs cannot see them. Our article on Google Docs heading styles and the document outline covers that foundation in more detail.
Step 1: Format Your Headings
Before you add anything, make sure every section title is a real heading.
- Select a section title.
- Open the styles dropdown in the toolbar, which usually reads Normal text.
- Choose Heading 1 for main sections, Heading 2 for subsections and so on.
- Repeat for each title in the document.
The keyboard route is faster: Ctrl+Alt+1 applies Heading 1 and Ctrl+Alt+2 applies Heading 2 (use Cmd+Option on a Mac). Keep the hierarchy logical, with no jumping from Heading 1 straight to Heading 4.

Step 2: Insert the Table of Contents
- Put the cursor where the list should appear, often after the title or on its own page.
- Click Insert in the menu bar.
- Choose Table of contents.
- Pick one of the styles offered.
The two common styles are different in purpose, as the table shows.
| Style | What it shows | Best for |
|---|---|---|
| With page numbers | Entries with right-aligned page numbers | Printed or PDF documents |
| With blue links | Entries as clickable links, no page numbers | Documents read on screen or on the web |
The official instructions are on Google’s help page, Add a title, heading, or table of contents in a document.
Step 3: Update, Edit and Remove It
After you rename, add or move headings, the table does not always update itself. Click anywhere inside it and use the refresh icon that appears at its left edge. Do this as a last step before sending the document to anyone.
- Update: click the table, then click the refresh icon.
- Adjust options: right-click the table and look for its options or customization choices, which let you change things such as which heading levels appear. The exact wording can differ by version.
- Remove: right-click the table and choose the delete option for the table of contents.
Which Headings Appear?
The table is built from heading styles. Ordinary text, even if it is bold, will not appear. The Title style is meant for the document name and is generally treated differently from section headings, so use Heading 1 for the first level of your list.

Common Problems and Fixes
- A heading is missing. Check that the text uses a heading style, not just formatting. Then refresh the table.
- The page numbers are wrong. Refresh after any edit that shifts content, including images and page breaks.
- Too many entries. Use heading styles only for real sections and keep minor labels in Normal text. You can also review which levels the table includes in its options.
- Links broken after copying. If you paste the content into a new document, insert a fresh table there.
Pasted text often brings stray formatting that confuses headings. If you work from Markdown drafts, see how to convert Markdown to Google Docs so headings arrive as true styles.
Using the Outline as a Companion
The same headings power the document outline, a navigation panel on the left of the editor. You can open it from the View menu, and it is useful while writing because it shows the structure at a glance. It also serves as a quick way to find a missing heading before you refresh the table of contents.
Tips for a Cleaner Table of Contents
A few habits keep the list short and readable. Give headings clear, specific names, because the table shows exactly what you type. Keep titles brief enough to fit on one line. Decide in advance how many heading levels the document needs, and stop at Heading 3 unless the content truly demands more. For long reports, put the table on its own page and refresh it as the very last editing step.
Frequently Asked Questions
Can I put a table of contents on its own page?
Yes. Insert a page break before and after it with Ctrl+Enter (Cmd+Enter on a Mac), or place it after the title on page one.
Does the table of contents update automatically?
Not always. Use the refresh icon to be certain it reflects the latest headings.
Will the links work in a PDF?
Links in the table of contents generally carry over when you download as PDF, but open the result and click an entry to confirm.
Can I change the font of the entries?
Entries follow the document’s styles. Adjusting the heading and normal text styles is usually the cleanest way to change the look.
Does it work on mobile?
Mobile apps can display and use a table of contents, though inserting one may be easier on desktop. Features vary by app version.
Wrap-Up
Apply heading styles, insert the table from the Insert menu, and refresh it before you share or print. With consistent headings, the whole process takes less than a minute.



